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etro gaming is part of Raspberry Pi that needs no 
O introduction. We all grew up with video games and 
characters we know and love. 
Creating a retro computer with Raspberry Pi is a rite 
of passage for new owners, and one of the best ways to 
rediscover the classics of years gone by. 


Lucy 
Hattersley 


Lucy is editor of 


; è Cai : h j and j 
Retro gaming with Raspberry Pi Pico, however, is a B NS ee 
ws : on her own 
much newer concept. The RP2040-based microcontroller aoe an 
development board is increasingly capable of powering DEERE: 
š i @LucyHattersley 
retro gaming and computer projects. 


This month, we tasked KG Orphanides to put their 
considerable retro gaming expertise into squeezing the 
most out of Raspberry Pi Pico W for retro gaming (page 34). 

Meanwhile, Rob has built a vacuum direct from Luigi’ s 
Mansion with Pico (page 58), and Phil has built a Mood 
Light with Raspberry Pi Pico (page 48). 

There’s a wealth of really great makes in this month’ s 
magazine. We hope it inspires you to start building your 
next project. 
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New update to 


The latest version of the operating system introduces a 
search menu and new networking options. By Simon Long 


& Get Started 


& Imager 


(Gas) Image Viewer 


Search items in the 
menu by pressing 
the Raspberry Pi (or 
Windows) key and 
entering text 
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rg) Geany Programmer's Editor 


a] Task Manager 


aspberry Pi has just released the latest 

version of Raspberry Pi OS. This time 

around, it is a wrapping-up of all the bug 
fixes and new versions of the software that have 
been released since the previous image in April. 
There are a few small tweaks to the user experience 
that are worth knowing. 


New searchable main menu 
For people who would rather type than move the 
mouse, Raspberry Pi has modified the main menu 


New update to Raspberry Pi OS 


plug-in on the taskbar to allow text searching. Just 
hit the Raspberry key on your keyboard (which is 
usually the Windows key on a non-Raspberry Pi 
keyboard) to open the main menu, and start typing 
the name of the application you want to launch. 
When you start typing, a search box appears, along 
with a list of all the applications whose names 
contain the text you have typed. 

You can move the cursor with the up and down 
arrow keys, and then just hit ENTER to launch the 
one you want, or double-click it with the mouse. 


If you don’t start typing anything, the main 
menu will continue to work exactly as it did before; 
this is just additional functionality, not a 
replacement for the existing menu. Note that the 
search box only appears once you start to type text; 
you don't see it if you just open the menu and use it 
as normal. 


New audio input control 

In previous releases, the volume icon on the 
taskbar could be used to select both output and 
input audio devices. For this release, this has been 
split into two separate icons, one for output and 
one for input. If you connect an audio device which 
is capable of input, either via USB or Bluetooth, a 
microphone icon will appear on the taskbar next to 
the existing speaker icon. 

To select the audio input device, right-clicking 
the microphone will show a list of the input 
devices available, and you can then click the one 
you want to use. 

Also, left-clicking the microphone icon brings up 
a volume control which can be used to adjust the 
input level or mute the microphone completely. 


Picamera2 

This release includes the new Picamera2 Python 
camera interface. This is a higher-level interface 
than the existing libcamera and is easier to use. 


New keyboard shortcuts 
One thing that a few people have pointed out is that 
it is not possible to access the Bluetooth and 
wireless LAN menus on the taskbar from the 
keyboard; you need a mouse to use them. 

In this release, Raspberry Pi has added keyboard 
shortcuts to access this functionality — hitting 


THE WORLD OF RASPBERRY PI | MägPi MN 


$ D @)) 17:41 


CTRL+ALT+B opens the Bluetooth menu, and 
CTRL+ALT+W opens the wireless LAN menu. Once 
the menu is open, the cursor up and down keys can 
be used to navigate. ENTER selects the highlighted 
item, and ESCAPE closes the menu. 


NetworkManager compatibility 

In previous releases, Raspberry Pi has used a piece 
of software called dhcpcd to manage a lot of the 
networking functionality. In particular, it 
manages connection to WLAN networks - when 
you click the network icon on the taskbar and 
choose a network from the menu, this is all 
controlled by dhcpcd. 


m Raspberry Pi has modified 
the main menu plug-in on 
the taskbar Ø 


Many other Linux distributions are now using a 
piece of software called NetworkManager to do the 
same job, which seems to be becoming the de facto 
standard, so they have added the option to use 
NetworkManager in Raspberry Pi OS. At present, 
dhepcd is still the default - you need to switch to 
NetworkManager if you want to use it — but in 
some future release, NetworkManager will become 
the default. 

NetworkManager adds a bunch of extra features 
which you may find useful. It allows you to easily 
connect to wireless networks with hidden SSIDs. 

It makes managing VPN connections more 
straightforward. And it allows you to easily 
configure a Raspberry Pi as a wireless access point. 
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There is a new look 
for the audio control 


MS Mägi | THE WORLD OF RASPBERRY PI 


A Anew network 
manager is activated 
in raspi-config and 
offers additional 
features such 
as creating a 
wireless hotspot 


$ =F © 1828 


have made any customisations 
to a wired connection, such as 


Turn Off Wireless LAN 


Y VM2470424 
SKYXTRZP 
Virgin Media 
VM128638-2G 
VM1522000 
VM9618440 
Connect to Hidden Wireless Network 


Create Wireless Hotspot 


Add VPN Connection 
Connection Information 


Edit Connections 


NetworkManager support should be regarded as 
a beta feature for now — there may be a situation 
where something doesn't work as expected. If 
you rely on Raspberry Pi to have glitch-free 
networking, the safest thing to do is to stay on 
dhcpcd for now; but if you want the new features 
and are happy to live with the possibility that it 
may be slightly less reliable, then feel free to try 
NetworkManager - you can always switch back to 
dhcpcd if you have problems. 

To switch to NetworkManager, just opena 
Terminal window and type: 


spi-config 


This launches the configuration tool. Go into 
option 6, Advanced Options, and then into 
option AA, Network Config - choose option 2, 
NetworkManager, and then reboot when prompted. 

Once rebooted, NetworkManager should be 
running - to check, open the wireless LAN menu 
on the taskbar. It should now include an additional 
sub-menu at the bottom, Advanced Options ~- this 
is where you can connect to a hidden network, 
create a hotspot, or set up VPN connections. There 
are also a couple of useful information dialogs 
which allow you to see and change parameters for 
any network connection already configured. 

Once you have switched to NetworkManager, 
you will need to reconnect to any wireless 
network to which you were connected under 
dhcpcd - connections do not automatically 
transfer between the two systems. Similarly, if you 
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Advanced Options 


setting a static IP address, you 
will need to redo those 

a; customisations under 

az NetworkManager. (Most of 
a: these settings can be accessed 


so = via the connection editor, 


a: accessed from the “Edit 
Connections” option in the 
Advanced Options sub-menu.) 
In order to use a VPN, you 
need to install the relevant 
VPN plug-in. The OpenVPN 
plug-in is useful for many 
networks. To add it, open a 
Terminal window and type: 


sudo apt install network- 
manager -openvpn-gnome 


When this has installed, choosing the ‘Add VPN 
Connection” option from the Advanced Options 
menu will open a dialog offering OpenVPN as a 
connection type. 

If you find that NetworkManager is causing 
problems, you can use raspi-config to go back to 
dhcpcd - just enter the Network Config option as 
described above, and choose option 1, dhcpcd. Ml 


How to upgrade 


The new image is available for download 

from Raspberry Pi's downloads page 
(magpi.cc/downloads). lt can also be flashed 
straight to an SD card using Raspberry Pi Imager 
(magpi.cc/imager). To update an existing image, 
use the usual Terminal command: 


sudo apt update 
sudo apt full-upgrade 


Then, in order to load the new taskbar plug-ins, 
launch Appearance Settings from the Preferences 
section of the main menu, and on the Defaults tab, 
press the button corresponding to the size you 
prefer. Then reboot - this will reload the taskbar and 
load the new plug-ins. 

To install NetworkManager on an existing image, 
open a Terminal and type: 


sudo apt install network-manager 


English not your 
mother tongue? = 


The MagPi is also available in German! 


Subscribe to the German edition of 

The MagPi and get a Raspberry Pi Pico 
with headers and a cool welcome box 
FOR FREE! 


Use the coupon code N5PicoDE L 


on www.magpi.de/115 
N 
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LEGO 
Submarine 4.0 


The challenge of keeping a LEGO-based submarine afloat is 
solved with Raspberry Pi Zero W, as Rosie Hattersley finds out 


“middle-aged guy from Finland” who PEK "NOR Me AA At SOS KASAAN 

dreams up, and then painstakingly creates, / [EEE GM wd Oa N ths Teds ts 
working models that address complex physics i 6 j y Be y 
and mathematical challenges. His latest build, AP DATA GA AAA II 
LEGO Submarine 4.0, runs off a LEGO EV3 motor 
and Raspberry Pi Zero 2 W. Like all his builds, the 
. submarine project is thoroughly documented on 
Brick g his YouTube channel, Brick Experiment Channel 
Experiment (magpi.cc/becyoutube), where his methodical 
Channel approach to construction and problem-solving have 
earned him more than 2.7 million subscribers. 


T his LEGO builder extraordinaire is a 


force”); a balloon, and an air compressor to adjust 
the amount of water displaced, thereby controlling 
whether the submarine sinks or rises; and a piston 
ballast to suck in more water to add weight and 
increase the sub’s gravity. 

He settled on the last method for Submarine 4.0, 


Software engineer 


BEC has a lifelong 
passion for 
designing builds 
using LEGO 
Technics parts. 
Raspberry Pi has 
proved invaluable 
to their most 
recent projects. 


magpi.cc/ 
brickexperiment 


This is the fourth LEGO submarine design he has 
completed. The first three variously used propellers 
to add or reduce buoyancy (“gravity and buoyancy 
stay always the same while the propellers exert 


despite the difficulty of gauging the neutral 
buoyancy point. However, it had proved a more 
stable setup and would not compress under 
pressure when submerged. Most importantly, “you 


> A submarine needs 
a captain, which 
was easily supplied 
in the form of LEGO 
part ID col154 
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A geared syringe attached toa 

hose, with its other end outside 

the hull, draws in or expels 

water, thereby controlling the ñ 

submarine's weight, allowing it The LEGO EV3 Medium motor 

to sink or rise å has an on-board tachometer 
which provides information for 
the control loop that constantly 
checks the submarine's position 
and adjusts its depth as needed 


Quick FACTS ~ i AM 


> Submarine 4.0 took 
hd Sih ’ np ( roughly 300 hours 
An absolute pressure sensor and FE ' AS i to make 

laser sensor monitor the submarine's ha / : À 


depth, while a Raspberry Pi Zero 2 W ; Í > The maker's 
PID control loop uses this information , y i i ; philosophy is that 
to adjust the syringe ballast p ` p tt ; i Y you learn by doing, 


one step at a time 


Code for the 
j project is at: 
magpi.cc/ 
i sub4code 


- 
v 


v 


He enjoys the data 
logs that Raspberry 
Pi produces 


v 


He uses this script 
to incorporate 
them in his videos: 
magpi.cc/ 
log2labelpy 


| 4 Weighing the 


ON / OFF AA eS assembled 
WIKI DA A Ñ Scape 
hesp TARE AR í 40 Croker ARA ~ submarine in 
NN TTM ANTAS A A AU order to work out 
ICA MN EN NRO Y AQUA SUSAN R te nik Oo SAE its displacement 
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A Raspberry Pi's PID 
control loop takes 
depth information 
from the sensors 
and uses it 
to adjust the 
syringe ballast 


w Arigorous series of 
underwater tests 
saw Submarine 4.0 
submerged ina 
murky river 


PiDoutput 


unit: ml 


syringe 
positioning 


process 


m He attached a magnet 
on the inside top of the 
Submarine frame so he 
could 'fish' the craft out 
of danger Ø 


can measure the piston position with a LEGO EV3 
motor that contains a tachometer. That will help 
the control loop.” This loop is also the reason for 
using Raspberry Pi: as we reported last issue, he had 
recently made an impressive inverted pendulum 
that uses a PID (proportional integral derivative) 
control loop running on Raspberry Pi Zero 2 W to 
accurately measure and compensate for constantly 
changing speed, location, and pressure levels. 

He planned a similar setup here, to monitor and 
control the submarine’s depth. He soon found 

the wireless LAN connectivity invaluable when 
tweaking the PID parameters and updating any 
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pressure sensor 


Python code without having to physically connect to 
the Pi Zero 2 W via USB (which would have involved 
carefully extracting everything from the precision 
environment he’d created). He now says wireless 
LAN is “an absolute necessity” which “made the 
development process a lot faster.” 


Underwater flying machine 
A fair amount of time and effort went into creating 
the submarine’s beautiful transparent acrylic case 
with tightly fitting and invisible end caps. The basic 
acrylic cylinders were precision-cut and end pieces 
with rubber seals attached to form a waterproof 
unit. LEGO gears were fitted to control the syringe 
that would adjust the buoyancy. 

An absolute pressure sensor (which measures 
pressure relative to a vacuum, and is unaffected 
by the ambient pressure) is used to track the 
submarine’s depth. It connects to Raspberry Pi 
Zero 2 W via 12C. A SparkFun TFMini-S Micro laser 
sensor provides a second means of measuring the 
submarine’s depth, but its accuracy is affected by 
the murky environments in which he was using it. 


A more successful purchase was the radio board 
he harvested from a cheap Chinese toy submarine, 
having chosen it for its 27MHz radio frequency 
(needed to penetrate water) and its aesthetically 
pleasing controller. Raspberry Pi provides enough 
juice to power the board, so he decided to discard 
its LiPo battery in favour of a LEGO waterproof 
rechargeable battery pack. 


Diving for pearls 
In Submarines 2.0 and 3.0, he used lead pellets to 
provide extra weight, but they were quite sizable 
and took up valuable space inside the submarine’s 
frame. For this version, he splashed out on 
expensive 2.5mm tungsten pellets weighing 
18 g/cm3. Weighed on a kitchen scale, the submarine 
was 826g, with a displacement of 1614 g. He added 
580 g of tungsten pellets to make the submarine 
dive gently, making adjustments using the syringe. 

To prevent entanglements while on manoeuvres, 
he attached a magnet on the inside top of the 
submarine frame so he could ‘fish’ the craft out 
of danger, if needs be. With lots of weeds and 
obstructions on the river bed, he was keen to avoid 
collisions, especially as it cost more than 600 EUR. 

Thankfully, Submarine 4.0 has performed well in 
a range of environments from swimming pools and 
water tanks to a nearby river. “It drives well under 
water. The automatic depth control really makes 
controlling it easy, as you can focus on pressing only 
forward/backward and left/right buttons and forget 
the dive/surface buttons. I’d say the controls are as 
good as in Submarine 2.0, which has been the best 
so far,” he reports. 

Nonetheless, as a perfectionist, he notes several 
areas for improvement. Hl 


A River testing 
data with log 
info provided by 
Raspberry Pi 
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As well as a food syringe and LEGO gear 
wheels, you'll need a Raspberry Pi Zero 2 W 
with 16GB microSD card, a LEGO EV3 Medium motor 
with tachometer, and a 27MHz radio controller. 


A motorised LEGO gearing system adjusts 
the ballast syringe. A hose sucks in water and 
draws water into the syringe chamber. Buoyancy 
remains constant while the extra weight of water 
increases the gravitational pressure. 


A radio board and controller culled from a 
cheap toy provide a user-friendly remote 
control, powered by Raspberry Pi, with no need for a 
dedicated battery. 
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Pico Pocket 
Gamer 


A pocket console that's simple enough for a beginner 
to build - now that's Nicola King’s kind of project 


Grgo 
Mariani 


Grgo is a software 
developer 
working for IBM 

in Bóblingen, 
Germany, and a 
huge Raspberry 
Pi fan. 


magpi.cc/ 
picopocket 


Y Allthe parts for 
the project, pre- 
assembly; it's 
fairly simple to 
put together 


hile reminiscing about a retro 
W electronic game called Lights Out (a 

puzzler with a grid of lights), Grgo 
Mariani realised he could make his own updated 
version with an unused Raspberry Pi Pico. 

“I remember how I used to play it while visiting 
my family and think about working out a perfect 
strategy to solve each new puzzle. Since I recently 
became a father, I wanted my son to have this 
experience as well, but unfortunately, I could 
not find a shop where I could buy this product 
anywhere,” he recounts. This was the push 
he needed to start creating, and the result is a 
rather fun little games machine that is simple 
enough for a newbie. 


Newcomers welcome 

As the hardware encompasses just a Pico, a 
320x240 touchscreen display, and five mechanical 
switches, Grgo sees this as a very achievable 
make. All that’s required is connecting several 
Pico pins to the display and mechanical switches. 
“No resistors, no capacitors, no battery, no 
external power supplies... I would call this 
beginner-level,” he confirms. While he designed 
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a custom PCB to streamline his mini console, he 
says this is optional. 

On the software side, he’s created a simple 
engine to handle the key and touch inputs, update 
the game state, and draw to the frame buffer ina 
loop. “Each game shares one 320x240 frame buffer 
for drawing and one 64x64 texture buffer. There 
is also a 16kB space used for game state memory,” 
he explains. 

So far, he has created 14 games for the device, 
including his versions of Snake, Pong, and of 
course, Lights Out, and took a flexible approach to 
game development. “The end design became much 
more than that one single game, as I really took an 
agile approach while building it.” 

He wrote most of the open-source code himself 
while modifying a few parts from other projects — 
in particular for handling communication with the 
display. “I also adapted the ray casting algorithm 
[for] my Labyrinth game.” He emphasises that, 
from a coding perspective, he’s not using any 
advanced capabilities of Pico here. 

Apart from finding the time, as a new parent, 
to spend on his project, Grgo found that the most 
difficult element was choosing the right display 
and constantly rewiring the breadboard to adapt 
to the new pinouts. “It took me several months 
to find the right display... PCB design is also 
something I never did before, so I had to learn it 
from scratch.” 

Take a look at his useful YouTube video 
(magpi.cc/picopocketyt), which shows him 
putting the device together. 


Favourable feedback 

The response received around the Pico Pocket 
Gamer has been super-positive, and Grgo’s been 
bowled over by the reaction by some members 

of the Reddit community. “Some people already 
DM-ed to ask me how they can replicate the 
project. It brings me joy to think that I might have 


The 3.2-inch ILI9341 
LCD is equipped with an 
XPT2046 touch module 


7 
a 


' 
' 


at dda EE 
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Mechanical buttons are used for 
the player input; an extra button 
on the rear selects the game menu 


ignited a spark in someone to give their Pico, and 
some new project they have in mind, a try.” 

As for future projects, Grgo doesn’t have 
any concrete plans yet, but confirms, “it will 
have something to do with the Pico W, that’s 


m The end design became 
much more than that one 
single game Ø 


for sure.” One thing he would really like to do 

is to implement some of the algorithms from 
Michael Abrash’s Graphics Programming Black 
Book, and make a simple 3D game using them. 
He plans on adding more games to this console, 
and has been buoyed along by the momentum of 
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> It took Grgo around 
two weeks.. 


> „to write the main 
code and first 
six games 


> He estimates the 
cost of the build at 
around €40 


> He's received 
requests from 
friends to build 
them one! 


> Find all the 
details, including 
the PCB design, at: 
magpi.cc/ 
picopocket 


Grgo designed a custom 
PCB for his project. Pico 
fits onto the rear 


creating each game: “With every game finished, 
there was this drive to build just one more.” And 
surely that’s a sentiment that many makers can 
empathise with. Hl 


A Running a game on the Pico Pocket Gamer - it can even handle 3D graphics 
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Chasing 
Your Tail 


Turning the tables on trackers, a Raspberry Pi 3-based device that 
lets you know if you're being followed, hears Rosie Hattersley 


Matt 
Edmondson 


Digital forensics 
specialist for the 
US Department of 
Homeland Security 
and keen maker 
and tinkerer. 


digitalforensics 
tips.com 


sense tells them they’re being followed. 

A conversation with an intelligence 
handler concerned for their client’s safety led 
US government digital forensics expert Matt 
Edmondson to put together a Raspberry Pi 3-based 
alert system to warn of a potential tail. 

In true espionage style, the Chasing Your Tail 
device fits inside an anonymous black briefcase 
and silently flags an issue, should a tracker be 
identified. It looks for smartphones and other 
Bluetooth or WiFi-enabled devices that are actively 
scanning for connections — essentially any modern 
phone, laptop, or tablet - and lets the anxious 
‘mark’ know that the same device has been in close 
proximity for the past five, ten, or twenty minutes. 
Assuming the device that’s flagged isn’t on your 


E ven spooks get spooked if their Spidey 


‘ignore’ white list because it belongs to a travelling 
companion or colleague, there’s a chance it might 
belong to someone following you. 

Chasing Your Tail creator Matt notes that 
there are plenty of options if you want to track 
someone’s movements or digital activities, but 
few ways to identify whether it’s happening and 
pinpoint who’s behind it. “It's very depressing 
to see how many devices are out there to spy on 
people, versus how many devices detecting that 
people are being spied on.” 


Makers gonna make 

Matt works for the US government with a focus 
on open-source intelligence, and recently gave a 
talk on his anti-stalking device at the Black Hat 
security conference: magpi.cc/chasingyourtail. 


A Raspberry Pi organises previously d 
logged MAC addresses, and 
flags any recurring device names 
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The Raspberry Pi 3-controlled 
stalker detector sits neatly inside 
the ruggedised, waterproof 
suitcase, chosen for its anonymity 
so it doesn't attract attention 


Kismet network detection 
software and a wireless card 
constantly check network 
traffic and log devices 
looking for connections 


An on-screen alert flashes 
up if the same MAC address 
appears over a 20-minute 
time span, suggesting 
you're being followed 


r 


i 


a 


The device 
cost less than 
$100 to build 


Itwas field- 
tested in the 
Arizona desert 


No spooks have 
seemingly been 
stalked, so far 


As a thank-you 
for the anti- 
stalker device... 


..Matt and his wife 
received some 
personal anti- 
kidnapping training! 
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Y The deliberately 
pared back viewer 
provides at-a-glance 
alerts if someone is 
potentially tailing you 
as you drive 


He’s not your typical security expert, though. 
Matt first became interested in technology aged 10 
when, a year before she died, his mum bought him 
a TRS-80 computer as a Christmas present and he 
began to learn BASIC. 

Computing remained a hobby when he began 
a Career in law enforcement, but his self-taught 
skills came to the fore as he began reading up on 
how to fix and connect various office devices and 
equipment, “building things that needed to be 
built,” eventually leading to Matt being recruited 
as a technical agent in a government department. 
He credits not having a formal computing 
education as one of the reasons he has no fear of 
computers, since he’s never been aware of what 
boundaries there are supposed to be. Nonetheless, 
Matt eventually learned MySQL databases, PHP, 
and GIS mapping, developing a strong interest 
in digital forensics. A decade ago, this led to him 
developing and teaching an OSINT (open-source 
intelligence) class, including a sandbox activity 
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simulating possible security breach risk scenarios. 
At this point “a light switch flipped on about 

the need for far more situational awareness,” 

he explains. 


A second set of eyes 

Having spent 21 years working in digital forensics 
for the US government, Matt is keenly aware of 
the dangers that covert operations bring to both 
handlers and those being protected. Even the most 
security-conscious person carries a smartphone, 
however, and these can easily betray someone’s 
location by dint of the way they’re designed to 
constantly look for available connections. 

The challenge is not trying to give away your own 
location, he warns. “If I was trying to work out if 
someone was following me, I would go to three 
different places: I’d go grab a coffee, then maybe 
put gas in my car, then maybe go to a bookstore, 
and then I would look at and see, did I see any 
devices at all three locations?” 


Years later, an attendee at that OSINT class 
from a different agency contacted him with 
concerns. “He wasn’t worried about his physical 


safety; he was worried about the physical safety of 


this person he was talking to, and meeting with,” 
and wanted a second set of eyes. The man was 
after a physical detection device to use alongside 
the tradecraft and surveillance detection tools he 
already had. 


Matt field-tested his device 
in the Arizona desert, but 
admits urban environments 
present a bigger, more 
complex challenge 


In true espionage style, the device fits 
inside an anonymous black briefcase and 
silently flags an issue, should a tracker 


be identified 


Given his history of making things, Matt already 


had the hardware he needed, including a pair of 
Raspberry Pi 3 computers, barring a cheap $25 


display he bought online. “I can write ugly Python 


code that gets the job done usually.” A month 


later, Matt handed over the suitcase containing the 


promised anti-stalker device. 


MägPi 


Sniff out spies 


Being stalked can cause life-affecting anxiety and 
stress. For this reason, Matt's made the full code 
for his anti-stalking device available on GitHub: 
magpi.cc/cytgit. 


A Ser Loon 


To fresh setting up Kamet you need to conige a login Ths login s used for changing server semaga, accessing serte 
eformaton, aiding armaron. and Ofer pavieged actors 


This login mal be stored in .kismet/kismet_httpd.cont in the home dercmry of the user who launched Kismer, This server is 
running as dragem, and te login wil be sawed is ~Gragora/ kismet /hisset httpd.coat 


On a Raspberry Pi 3 or 4, update Apt and 

install the Kismet network analysis software 
(kismetwireless.net). Open a Terminal window in 
Raspberry Pi OS and install Kismet 
(kismetwireless.net). 


Follow the instructions at 

magpi.cc/cytprereqs to install all the required 
packages. Set up your Raspberry Pi as a known 
Kismet device by typing and check the pi user has 
been added to the groups. Create a logging directory 
to store your logs. Then to make the display and 
Raspberry Pi autostart. 


Set up and enable the wireless card, and 
enable monitor mode with crontab. 
Reboot and use the Create Ignore Lists option to add 
any known networks or devices to the whitelist so 
they aren't flagged as possible devices tracking you. 
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Serial Typewriter 


Riley Groeschel has taken an electronic typewriter from the late 
1980s and turned it into a Linux terminal, as David Crookes explains 


Riley 
Groeschel 


Riley Groeschelis a 
recent Mechanical 
Engineering 
graduate of Johns 
Hopkins University 
in Baltimore, 
Maryland. He loves 
breathing life into 
old electronics. 


magpi.cc/ 
serwriter 


Riley has been 
using the device 
to create some fun 
ASCII art too 


people still use typewriters today. There are 
government departments which tap away 
on them because they can’t be hacked and they 
are used in some capacity by banks, prisons, 
businesses, and law firms. 

Here at The MagPi magazine, we’re also taken in 
by a typewriter’s charm, from its immediacy and 
feel to the sound made as the letters are hammered 
on to the carriage. So, when Riley Groeschel 
decided to dust down a Brother AX-25 electronic 
typewriter and give it a new lease of life, we felt it 
was something to write home about. 

“Pve turned the typewriter into a Linux 
terminal,” Riley says, revealing that it wasn’t 
actually the original proposal. “Back in high 
school, my friend was working on a computer 
using a Z80 processor,” he adds. “We planned on 
taking his finished computer and putting it inside 
a typewriter so we’d have something similar toa 
Commodore 64, but we gave up because he never 
got the computer working.” 


| t may surprise you to know that some 
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Bashing out ideas 

At that point, Riley considered using his typewriter 
shell to create a cyberdeck (a retro-looking 
futuristic computer). “That idea floated around my 
head until I saw CuriousMarc’s video where he used 
a teletype as a Linux terminal and the idea was 
born,” Riley says. “I knew I had to replicate the 
experience of using UNIX on a teletype like it was 
done half-a-century ago.” 

To do this, Riley decided to put a Raspberry Pi 
computer at the heart of the typewriter, coming up 
with a way to fool the old machine into believing 
a key had been pressed. The aim was to print 
the output from a Terminal window but, at this 
stage, a laptop was being used as opposed to the 
typewriter’s own keyboard. 

At first, Riley connected two multiplexers to 
the typewriter’s keyboard 8x11 matrix and allowed 
them to be controlled by an Arduino Uno. “My 
Arduino is connected to my laptop over serial 
through a USB cable and I can send commands 
to it through the Arduino IDE’s serial monitor,” 
Riley explains. 

“When the Arduino receives a message from 
my laptop, it forwards it to Raspberry Pi which 
has the serial code on its UART pins enabled. 
Raspberry Pi forwards it to the Arduino with 
the output of the command that it received. 

The Arduino then ‘sends’ it to the typewriter 
using the two multiplexers to emulate the 
typewriter’s keyboard.” 


The right type 

As commands or words are typed, they’re banged 
straight out on to paper. Any resulting messages 
are also immediately printed. “I had to map out 
the typewriter’s keyboard one key at a time by 
connecting each pair of pins on the two keyboard 
connectors together, and 1 put that all into an array 
which let me connect the ASCII characters from 


>» 


Raspberry Pi to the typewriter’s ‘keycodes’. 


P ha 
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The project makes use of 
a Brother AX-25 electronic 
keyboard which has a 
small LCD display and 8kB 


Raspberry Pi acts as a serial memory. Output is via the 
monitor. An Arduino Uno i daisy-wheel print head 
is connected to it and the 


keyboard and messages are 
passed between the two 


The minimum 
communication rate 
between Raspberry Pi and 
Arduino is 1200 baud (150 
characters per second). The 
typewriter types at twelve 
characters per second 


After that was working, he connected the 
typewriter’s own keyboard to the Arduino. “The 
Arduino checks each pair of pins one at a time 
using the multiplexers until it detects that a key 
has been pressed,” Riley says. “Once it does, 
it sends that key to the Raspberry Pi computer 
for processing.” 


m | knew | had to replicate 
the experience of using 
UNIX on a teletype Ø 


Aside from working as a Linux terminal or as a 
teletype, the machine can also print large ASCII 
art, including a cool image of the Mona Lisa. 
Riley is also continuing to refine his project. “I 
plan on designing a custom circuit board that I'll 
install between the typewriter’s keyboard and 
motherboard,” he says. “I might even replace the 
typewriter’s keyboard with a custom mechanical 
one to improve the typing experience.” M 


~~ Quick FACTS 


> The daisy wheel 
mechanism dates 
to the 1970s 


> The project is a 
near-fully functional 
Linux terminal 


> It now uses the 
typewriter's 
keyboard 


> Watch the 
typewriter in 
action: magpi.cc/ 
typewriteryt 


> The code is 
on GitHub 


A Avoltage divider circuit has been created so that the 5V 
output of the Arduino is at a safe 3.3V level for Raspberry Pi 
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AuraLock 


Forgot your keys? With Dillon McCardell and Erin Stanfill's project, you can 
simply walk right up to the door and watch it unlock, as David Crookes explains 


Dillon 
McCardell & 
Erin Stanfill 


Dillon is a recent 
Computer 
Engineering 
graduate with a 
passion for design 
and development, 
taking ideas from 
concept to reality. 
Erin is a computer 
engineering 
graduate with a 
drive to continually 
learn, pushing 
technology into 
the future. 


magpi.cc/ 
auralock 


> Firebase's Python 
library was imported 
into software running 
on a Raspberry Pi 4 
computer which, in 
turn, was fitted with a 
Servo PWM Pi HAT 


24 | magpicc | AuraLock 


any of us use our face to unlock mobile 
M phones and tablets, but imagine ditching 

your keys and doing the same to enter 
your home. It’s that idea which underpins a 
project by Dillon McCardell and Erin Stanfill: a door 
locking system using facial recognition that uses 
off-the-shelf components. 

Called AuraLock, it’s primarily based around a 
Raspberry Pi 4 computer, a camera, door sensor, 
and Android mobile device. “Currently there are 
consumer facial recognition door locks, but they 
run on batteries and require push-button feedback 
to enable the facial recognition component,” 
Dillon says. “This defeated the purpose of a hands- 
free unlocking feature.” 

Although enterprise-level facial recognition 
security systems can connect to automatic sliding 
doors, they are very expensive, so Dillon and 
Erin looked to create a go-between. “We wanted 


something to theoretically cost the same as current 
consumer facial recognition door locking devices,” 
Dillon says. “It would be connected to your home’s 
power and contain a motorised deadbolt, allowing 
the system to be powered 24/7 and completely 
hands-free.” This, however, was not without 

its challenges. 


Slide away 
As well as needing to constantly search for a known 
face, the hardware module had to be mounted 
within the frame of the door. The deadbolt needed 
to be motorised so it could retract into the frame to 
unlock, and there needed to be a way of quickly and 
easily exiting a home without electronics getting in 
the way. 

“I implemented a simple sliding mechanism to 
replace the knob on a standard door — it was able 
to remove the deadbolt with a single motion,” 
Dillon says. “Other hardware features included the 
ability to unlock the door with facial recognition 
and an LED indicator on the exterior of the home 
to receive feedback. But other features, regarding 
usability and convenience, were primarily achieved 
in the Android mobile app.” 

These included remote unlock and the ability to 
add recognised faces. “We felt these two features 
would give the user a true smart home feel,” Erin 
explains. “People would be allowed to enter the 
home even if the owner wasn’t there, and adding 
faces gives the user the ability to adapt the door as 
needed. Yet, having never built an app before, the 
whole plan was a little intimidating.” 


Professional feel 
The pair also faced problems when implementing 
OpenCV to recognise faces. “The library is vast 
and difficult to install easily,” Dillon says. “Once 
OpenCV was installed, I realised it was not 
designed to accept new face encodings dynamically 
- all registered images were generally hard-coded 
on bootup.” 

To overcome this, Dillon implemented a 
dynamically updating dictionary, and he refreshed 


The deadbolt needed to 
be designed so that the 
gearing mechanism could 
be disengaged to allow it 
to be manually slid open 
for safety reasons 


This prototype uses a 12 MP 
camera module in a separate 
unit to the door but in reality, 


it would be incorporated 


== 


the OpenCV code to reflect the changes. The pair 
also used a Google Firebase database that allowed 


m Having to communicate 
with other devices through 
Firebase added a level 
of difficulty Ø 


for communication between Raspberry Pi and the 
Android app. “Having to communicate with other 
devices through Firebase added a level of difficulty 
that wasn’t anticipated at first,” Erin says. 
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> The system 
needs to be 
powered 24/7 


¥ 
Lia 


As well as a Raspberry Pi 4 
computer, this 3D-printed 
housing also includes the lock 
hardware and it's intended to 
fit inside the door-frame 


It unlocks when 
it recognises 
approved faces 


v 


AuraLock can also 
be controlled via 
an app 


Yy 


It uses the 
processing power 
of Raspberry Pi 4 


v 


v 


OpenCV has 
more than 
2500 algorithms 


v 


Erin originally wanted 
to create an iOS 

app. but decided on 
Android because 

of the availability of 
helpful resources 

at the University 

of Wyoming 


This was achieved by updating and reading 
database variables - they’d be updated when a 
new user unlocked the door, for example, and the 
mobile app would notice the change and show 
an image of the user who had activated the lock. 
“By implementing this method, we were able to 
transfer both variable values and images from 
Raspberry Pi to the mobile app and back again 
through Firebase,” Dillon explains. 

With Erin’s custom GUI containing an array of 
buttons and functions, AuraLock certainly ended 
up looking and feeling professional. “We feel that 
all features included in the app are key to a positive 
user experience,” she says. And it definitely put a 
smile on our faces. M 


FIXED UNLOCK Enter Time fin minutes) 
Time Remaining: O minutes 


canon FoR uoc 
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PicoKenbak 


Recreating one of the first personal computers 
with a microcontroller shows how far we've come, 
as Rob Zwetsloot finds out 


the Kenbak-1 using a Raspberry Pi 4 in 2:5 
scale - it’s considered to be the very first 
personal computer by many, and originally came 
out in 1971. Raspberry Pi 4 is definitely much more 
powerful thanks to Moore’s Law and, it turns out, 
so are microcontrollers. 
“[This] is something I call the PicoKenbak,” 


A few issues ago we featured a recreation of 


AMOS Kosmas Raptis tells us via email. “It’s a functional 
aptis recreation of the Kenbak-1, one of the first (if not 
A highschöal the first) personal computers, using a Raspberry 


student from 
Greece who works 
with computers 
and electronics in 
his spare time, and 
enjoys low-level 
and emulator- 
based projects. 


magpi.cc/ 
kosmasgit 


Pi Pico. My version does not really look similar to 
the original computer due to how I was not able to 
find a similar case or similar push-buttons, but it 
functions the exact same way for the end user.” 

Kosmas is a fan of low-level programming and, 
when asked to write a paper on how computer 
programming has evolved over the decades, he 
decided to dig deep and go the extra mile. 

“As I was researching about the beginnings of 
personal computers, I came across the Kenbak-1, 
and apparently this was a quite well-documented 
system, with the original creator having a website 
that explained how it was made and how it 
worked,” Kosmas explains. “When I saw that, I 


Kosmas had to 
improvise with a box, 
basically making it 
from scratch himself 


immediately realised it would be really cool for my 
presentation. However, it is not easy to get one of 
these, and the recreation kits were not really viable 
for me either, so I decided to build my own.” 


More Pico 

At the time of creation, Kosmas was interested 

in using Pico due to the low price, and because he 
wanted to see more cool Pico projects in the world. 
“Actually building the project was more difficult 
than I expected,” he says. “The case is basically 

a big metal box that I drilled some holes through 
and painted blue and was easy enough to create, 
but setting up the actual wiring was not easy. This 
project uses 15 push-buttons and 13 LEDs (one 
power LED connected to the power supply as an on/ 
off indicator, and eight I/O and four function LEDs 
connected to the Pico), which all had to be confined 
to the small space of the case. 

‘Everything was also hand-soldered, so there 
were some issues with soldering something at this 
scale for someone as new to soldering as me... this 
gets me to how the project actually works. The 


Kenbak-1 (and, by extent, PicoKenbak) had twelve 
LEDs. Eight of the them were used for data I/O, and 


A These octocouplers are needed 
for handling all the inputs 
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o 


m Actually building the 
project was more difficult 
than | expected El 


four of them were used for indicating that various 
functions were done, like clearing input, showing 
the current memory address, reading from 
memory, and stopping program execution. 
“Additionally, I had to use optocouplers to power 
the LEDs, to ease up power requirements on the 
Pico. There are also 15 push-buttons. Eight of those 
are used for inputting data to store into memory, 
and the other seven are used for functions. 
Clearing input (which I have wired to the Pico’s 
RUN pin), set/show memory address, read/store 
with memory, and start/stop program execution. 
This was actually a close one because, by the time I 
was done, I had used up every pin on the Pico.” 


Emulation and more 
Kosmas wrote an emulator in C, which handles all 
the original functions of the Kenbak-1. 
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rt 
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U 
r > 
Sy Programs run 
on the LEDs 


The buttons are used to 

program PicoKenbak, 

just like on the original Quick FACTS 

> A Maker Pi Pico is 
used to connect 
Pico to the system... 


> . as, unfortunately, 
Kosmas managed 
to short a few 
contacts soldering 


> The emulator 
currently runs as 
fast as Pico can... 


> .. Which is faster 
than the Kenbak-1, 
but Kosmas wants 
to fix that 


> Kosmas built the 
hardware first, then 
did the software 


_ = 
pra arado 
A e 


A Two Raspberry Pi Pico boards 
were used for the project 


“Programming is done the same way that it was 
done with the original Kenbak-1,” he explains. 
“The programmer uses the push-buttons to type 
an instruction byte in binary, and then stores 
the byte into memory. Program space can start 
at address 4 and end at address 127. By default, 
execution starts from address 4.” 

In the future, Kosmas plans to update it with a 
Pico W and add some wireless functionality, such 
as executing code over a network. If you want to 
check out the emulator, the code is available online 
at magpi.cc/picokenbak. [l 
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Directed Machines' Raspberry Pi-based Land Care Robots 
fulfil precision agricultural tasks and are both customisable 
and repairable, reports Rosie Hattersley 


ith the global population steadily rising, 

optimising agricultural productivity and 

land use to grow enough food is an ever 
more pressing issue. Raising crops is a precision 
industry, and one in which farmers are constantly 
under pressure to produce more from their acreage 
in order to meet the demand for food, at a cost to 
keep their main customers, the supermarkets, 
competitive. Minimising the use of pesticides and 
fertilisers is critical to maintaining profits, as well 
as preventing soil degradation, while labour to sow 
and harvest crops is in increasingly short supply. 
Seasonal labour shortages can be eased by drafting 
in casual workers from other states or countries, but 
the bigger trend is towards the increased 
mechanisation and industrialisation of farming. 

Directed Machines (directedmachines.com) is a 

small but important player in the agri-robots 
sector, developing and marketing Land Care Robots 
(LCRs) for a wide range of vertical markets. 
Raspberry Pi 4 is a crucial aspect of the company’s 
successful designs (magpi.cc/robotfarmers). 


Directed Machines 


THE CHALLENGE 


When George Chrysanthakopoulos stepped away 
from a prestigious 21-year career in software 
development, he was keen to capitalise on his 
thorough knowledge of robotics: he was the 
technical lead of a large (1,000+ employees and 
subcontractors), secret, consumer robotics initiative 
at Microsoft before moving to VMware, where he 
became a fellow. For his own, post-industry, project 
he began designing solar-powered robots to help 
deal with the annual snowfall. Discussions with 
neighbouring small-scale farmers quickly 
convinced George there were myriad possible uses 
for robots in agriculture, and there was a healthy 
market for low-cost mechanised assistants that 
could help solve some of their pesticide and plant 
management. Profit margins on small farms are 
especially tight and farmers would need to be able to 
perform multiple tasks and to repair their robot 
on-site, meaning readily available parts and a fairly 
simple but robust hardware was imperative. 
Nonetheless, there seemed to be a market for 


relatively low-cost, heavy-duty, solar- 
electric, autonomous machines. 
Robots could have multiple uses 
across the growing season — preparing 
the ground, applying fertiliser and 
pesticides, sowing seeds, removing 
weeds, transporting seedlings from 
place to place ready for planting out, 
and harvesting the crops. Each of 
these tasks would need to be 
performed accurately in order to 
justify the robot’s outlay and be a true 
replacement for hard to find seasonal 
manpower. The right to repair is a big 
issue in the agricultural industry, so 
there were important considerations 
regarding maintenance and the 
servicing of complex machinery. 


WHY RASPBERRY PI? 

George founded dCentralized Systems and set 
about developing a modular robot that could be 
used for a variety of agricultural tasks. Prototypes 
of the first Directed Machines-branded product, 
a laser-guided autonomous weeding robot, had 


m You can attach different 
implements to our robot El 


field trials in early 2018 and were followed by the 
more powerful Land Care Robot - the base unit for 
Directed Machines’ modular offering. 

The Land Care Robot was built around Raspberry 
Pi for cost reasons, as well as the reliability and 
availability of hardware. The company reasoned 
that with a huge installed base and active 
community, the chances of bugs being found in 
Raspberry Pi modules was minimal. This, of course, 
is critical when it comes to machinery that may be 
remotely located and would therefore need to be 
updated or replaced by customers. “If you can do it 
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on a Raspberry Pi, there are huge advantages to 
doing [so],” says Dan Abramson, Directed 
Machines’ co-founder and COO. “You’ve sold 
millions and millions of units, the chances of bugs 
popping up are really, really low.” He also 
mentions the “richness of the ecosystem around 
the Raspberry Pi” and the relatively low energy 
requirements. “So if you can do it on a Raspberry 
Pi, there are compelling reasons to do it ona Pi.” 

Dan adds: “We like 3iC architecture, and 
Raspberry Pi is a very beautiful match for our first 
principles, algorithmic architecture philosophy. 
Instead of throwing brute-force computing power 
at solving engineering problems, we leverage the 
structure inside those problems to reduce the 
computational requirements related to those 
problems. After imposing those structural 
constraints, and reducing the scope of the 
problem, Raspberry Pi is a beautiful tool, a 
beautiful partner to execute the calculations that 
we need to execute.” 


THE RESULT 

Directed Machines has been selling across North 
America in constrained fashion for the past two 
years, meaning plenty of advance research to 
ensure Land Care Robots are a suitable fit for each 
client’s needs. Development was entirely in-house 
and took just two years including mechanical 
development, electrical development, and all the 
software development. For the past two years, 
Directed Machines has been selling into market 
and deploying the Land Care Robot platform “in 
all sorts of different interesting use cases and 
verticals,” says Dan. “It’s an autonomous robot, 
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powered by a file, so you can attach different 
implements to our robot to allow it to perform 
different tasks. You might attach a mower deck 
to our robot to allow it to mow grass. You might 
attach a snowplough to our robot to allow it [to 
plough snow], you might attach a cart to our 
robot to allow it to pull whatever it is you want to 
be pulled in. 

“With certain agricultural customers, as their 
crop comes to harvest, the crop is attacked by birds 
and other predators seeking food. We’ve attached a 
sky puppet, like you would see at a car wash, to the 
back of our robot, and the robot moves around 
fields or the orchard autonomously, carrying the 
sky puppet scaring away the birds. 

“Other customers include golf courses, solar 
farms, rural properties, and nurseries that have to 
tow potted plants in very heavy volume. The LCR 
can be deployed in a wide range of terrain settings, 
from very, very flat properties that we need to 
perform tasks on, to one we have in Southern 
California that overlooks the Pacific Ocean, 
where the terrain is 55 degree slopes. The 
Raspberry Pi-powered LCRs are now also working 
full-time at utility scale on solar farms in the U.S. 
and have been warmly welcomed in Europe and 
Oceania too.” 

As well as handling very challenging terrains, 
the Land Care Robots are fully autonomous and are 
capable of completing multiple tasks without user 
invention. “We keep adding features to what we do 
all the time, and we continue to improve the 
robustness of our engineering and to experiment 
with new sensors. We are doing that more and 
more, using sensors that we find in Raspberry 
Pi’s ecosystem.” 

Working alongside a curated set of customers 
during field tests, and since, has worked well for 
both sides: clients get early access to new features 
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while Directed Machines gets invaluable, directly 
applicable feedback. Britt Fletcher owns Mutiny 
Bay Blues in Washington, and is a Directed 
Machines investor. His organic blueberry farm 
“focuses on regenerative farming practices and 
keeping our carbon footprint as small as 
possible.” Directed Machines approached Britt 
two years ago, keen to use Mutiny Bay a test site 
for its robotic solar-powered machine. “The Land 
Care Robot’s ability to mow acres of a very 
structured row environment, as well as many of 
our open areas, while not using gas and also 
freeing up a farmworker to handle more difficult 
tasks, made coming on board an easy decision,” 
says Britt. Working in a high-stakes structured 
environment can be a particular challenge and, at 
first, the accuracy was not where it is now, says 
Britt, but LCR updates developed in response to 
Britt and other customers’ feedback means Mutiny 
Bay now has a machine that Britt trusts to work 
“totally unsupervised in the rows,” as this video 
shows: magpi.cc/automowing. 

“The cost is about three quarters of what it had 
been and, more importantly, frees up increasingly 
scarce human capital.’ 

In 2021, Blueweave Consulting estimated 
the smart agricultural robot market to be 
worth approximately $11.5B, and predicts 
this to nearly double to $ 24.3B by 2028, citing 
demand for precision agriculture as a key driver 
(magpi.cc/agrirobotsmarket). 

Daren Richins runs an ‘entrepreneurial’ farm in 
Utah. He believes the direction agriculture is 
headed is “fairly obvious”, with labour shortages 
and increased capital expense taking a big toll on 
farmers. “I think the answer to these challenges 
lies within robotics and technology. As I’ve had the 
opportunity to work with my Land Care Robot, I’ve 
been able to peer into a not-so-distant reality that 
relies quite heavily on this type of technology to 
satisfy the challenges we face today in agriculture. 
Directed Machines has been an excellent partner in 
taking this bull by the horns.” H 
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What kind of video games can you run On a $6 microcontrolle 


rom Dizzy to Doom, Raspberry Pi Pico 

and Pico W are holding their own HELLO THERE ... 

against far more expensive emulation 
systems, and they’re ready to play almost 
as soon as you power on. With the July 2022 
launch of the Raspberry Pi Pico W, equipped 
with wireless networking capabilities, there are 
a few more features to be tapped. 
umerous mature and highly capable 
emulators have been ported to Pico, allowing 
you to run huge chunks of the 8-bit computer 
and console eras, with hardware kits and 
expansion boards that make it easy to connect 
monitors, controllers, SD card storage, and 
high-quality audio. 
Unlike top-heavy computer emulators 
designed for computers and capable of running 
almost anything, if you spend enough time 
poking at the menus, RP2040 emulators 
become embedded systems, single-purpose, 
responsive, and fast-booting, just like the 
original hardware they’re emulating. 

Emulation is all well and good, but you 

can also use your Pico to bring brand new 
homebrew games to real retro hardware 
platforms, giving new life to beloved classic 
consoles. We’ve showcased two different flash 
carts, for the Nintendo Game Boy and N64 
respectively, that use Pico with custom PCBs, 
that allow you to write your own retro console 
cartridges at a far lower cost than dedicated 
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A A Play indie gems from modern C64 developers 
E commercial flash carts. and publish like Psytronik’s Honey Bee 
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Í LESAN MANY N 
eN \ A Relive the gory 


Backspere glory days of the 
fe $ yo Doom, beloved by a 
; 


generation of gamers 


If you’d rather work with fresh hardware, we on your local network by using Raspberry Pi il 
have the YouMakeTech’s Pico ‘GameBoy’, a colour Pico as a tiny web server. We're sure Pico W’s 
handheld console that wears its inspiration on future holds even more ambitious networked x 
its sleeve but is, in fact, designed to run and gaming applications. 
inspire the development of brand new games in 
MicroPython or C. 
This little microcontroller can even play Doom, at} 
thanks to the gruelling porting and optimisation 
work invested by Raspberry Pi’s in-house Pico oO 


SDK lead and classic games enthusiast Graham 
Sanderson, who’s also responsible for the Pico’s 
BBC Micro emulator (b-em) port. 


Because this year marks the 50th anniversary Join us on a whirlwind tour of some of the 
of the first arcade release of Atari’s Pong, coolest Pico gaming projects. Whether you’re 
on 29 November 1972, we’ve included the interested in hacking hardware, developing 
minimalist table tennis classic, showcasing software, or just hooking up fully functional 
a project that’ ll have you create a rainbow- gaming experiences on the most cost-effective 
colour handheld incarnation of the game, and hardware around, there’s something here to Pico 
demonstrating how to host a game of Pong your interest. 
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o SDK lead Graham Sanderson 


e talc to seen Hee om in all its glory to RP2040 


about accurately porting Do 


raham Sanderson, Raspberry Pi Pico SDK part of his role working on the RP2040 SDK 
G lead and performance architect by day, has perhaps been, “taking 30-plus years of 

took on the challenge of making Doom development and applying it to the constrained 
run on the microcontroller in 2021. The game microcontroller environment, which has a 
would be released in March 2022 after six months similar feeling set of constraints to the home 
of development, but the first public evidence computers I had as a child.” 
of the scheme appeared a year earlier, when He based RP2040 Doom on the Chocolate 
Sanderson tweeted: “RP2040 Doom must be a Doom (chocolate-doom.org) port of the original 
thing, but if I do it, it needs to run all the demo source code, itself designed to remove some 
WAD properly.” of the limitations associated with the original 

Sanderson grew up with the Sinclair ZX81 DOS version. 


and BBC Micro. He says that the most fun The greatest challenge, he says, was getting the 

entire 4MB demo to fit, along with the game itself, 

into the Pico’s 2MB flash storage. “The original Xx 

game data file from Doom (DOOM1.WAD) is over 

4MB big, and I have included everything: all the 

graphics, levels, music, sound, splash screens, 

Artin Girt multiplayer networking - the lot.” 
Particularly impressive is a tool called whd_gen, 

part of the RP2040 Doom codebase, that converts 

and compresses WAD files into a custom format 

that reduces the level files’ size by up to 57% in 

the case of DOOM1.WAD. WHD, which stands for 

‘Where’s Half the Data”, is particularly effective 

at reducing Doom’s graphical overheads, detailed 


Alert! in Sanderson’s behind-the-scenes article on the 
Copyright See techniques used to create this port. 
— connections are 
Video game files are Pimoroni Pleo VGA A Pico porting projects 


protected by copyright 
law. Be sure to use 
ROM files that have 
been released with 
the owner's blessing, 
or modern homebrew 
games designed to be 
shared. There are lots 
of legal options. 


Demo Base } Doom is by no means Sanderson’s first venture 
bide il Aa WAN into porting classic games to the RP2040: 
=- E ANN “The very first thing I ported was actually a ZX 
pind E E Spectrum emulator. It is on my list to open- 
source; it is just in a bit of a mess. This one was 
actually developed while we were still developing 
the RP2040 on FPGA and, so, was limited to a 


magpi.cc/legalroms 
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system clock of 48MHz. It also, at one point, ran 
with less memory.” 

The ZX Spectrum emulator wasn’t cycle 
accurate, but this didn’t really matter as far as 
the performance of most Spectrum games is 
concerned. But that doesn’t apply to every retro 
emulation system. 

“Given the new-found freedom of a higher 


clock rate,” — the production version of Raspberry 
Pi Pico has a maximum clock speed of 133MHz - “I 


thought I’d have a go at porting a BBC emulator 
where it is critical that everything happens at 
exactly the right cycle.” 

Sanderson says he does it for the challenge, to 
see if it’s possible. That's a sentiment you’ ll hear 
from a lot of the coders and hardware hackers 
we’ve spoken to for this feature. 

“T usually start with another code base, 
and of course they are never designed to run 
on something this constrained. [The] first 
thing is generally to divorce them from the 


mHe does it for 
the challenge Ø 


idea that look-up tables many hundreds of kB 
big are a good idea, and [I] generally have to 
rewrite large portions with some sort of new 
methodology [or] approach and redo certain bits 
in assembly language.” 

RP2040 Doom shows the huge potential of one 
small microcontroller, a great deal of patience 
and determination, and three decades’ worth 
of experience. 

But you don’t need to start with that level 
of experience to begin working on your own 
Raspberry Pi Pico projects. And if you prefer using 
other people’s work as a platform for your own, 
higher-level projects, or as the basis of a really 
cool make, there’s a wealth of kits and code to 
enjoy playing with. 


Download your own Doom 
You can download the release binary of RP2040 
Doom at magpi.cc/rp2040doom, enter BOOTSEL 
mode, and copy the UF2 file you want over to 
it. To run it, Pico will have to be connected toa 
vgaboard-compliant RP2040 graphics board. The 
larger, 4MB file is designed for other RP2040- 
based devices, with more flash storage. 

It’s designed to run with a Pimoroni Pico VGA 
Demo Base (magpi.cc/vgademobase), which is 
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functionally identical to the “VGA, SD card, and 
audio demo board” described in Raspberry Pi’s 
“Hardware Design with RP2040’ documentation 
(magpi.cc/rp2040hardware). Sanderson notes, “It 
is a lot easier to use the VGA Demo Base, though!” 

Although that’s the easiest way to hook up 
display, controls, and sound, it’s not the only way. 
In some of Sanderson’s YouTube videos of the 
project, you'll see a breadboarded version of the 
setup, with the video GPIOs hooked up to a VGA 
connector via a resistor DAC and the audio ones to 
an PCM5102 12S DAC board. 

You can read a full account of Graham 
Sanderson’s feat of optimisation at 
magpi.cc/makingrp2040doom. 
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A fully-fledged retro computer in your pocket, 


with DB9 joy 


stick input and VGA output 


ne of the most impressive Pico project 
O kits around is Peter ‘Bobricius’ Misenko’s 

RetroVGA, a Raspberry Pi Pico multi-retro 
computer which equips the microcontroller 
with a VGA output, DB9 joystick port, QWERTY 
keyboard, 3.5mm audio output, integrated piezo 
speaker, USB port for input devices on supported 
emulators, and an SD card slot for storage. 


The whole thing measures just 10cm square, 
small enough to fit in a coat pocket, just in case 
you need to carry a retro microcomputer around 
with you. If you use a DB9 joystick, you’ ll need 
to reduce its cable length to around 30cm, or it'll 
register false key presses. 

The keyboard isn’t quite full, lacking 
F-keys that are needed in some C64 titles, for 
example. The RetroVGA’s sister device, the 
PICOZX (magpi.cc/picozx128) changes the 
number of GPIO pins devoted to VGA output to 
add extra keys, if that’s a deal-breaker for you, 

but with a limited number of GPIO connections, 
compromises have to be made somewhere. 
Once you’ve selected your game from the 
RetroVGA’s SD card storage, the keyboard 
means you can LOAD and RUN it, and there 
are even directional keys to play with. 
RetroVGA was first built to work with 
MCUME, Jean-Marc Harvengt’s Multi 
CompUter Machine Emulator, and Miroslav 
Nemecek’s PicoVGA display library. It now 
also supports Phil Scull’s more feature- 
packed pico-zxspectrum emulator. 


PicoVGA graphics standard 
Harvengt and Nemecek were closely 
involved in the development. The 


A You can buy RetroVGA as 
a single PCB to mount your 
components on, as a pair with 
an optional top panel, or in its 
final form as a fully assembled 
multi retro computer 


RetroVGA board’s video output 

wiring is compliant with the 
PicoVGA standard, and not with 
the Pico SDK’s default vgaboard standard. 
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Raspberry 
Pi PICO 


supporting quicksave states, as well as USB 
keyboards and joypads. 
; Even when using a multi-device emulator such 
BOErICIUS | as MCUME, you’ll use one emulator at a time. 
SEN - Se - MCUME binaries are available to download at 
| N | ( magpi.cc/picoretrovga and the UF2 files for pico- S< 
zxspectrum all live at magpi.cc/zxuf2. 
While some of the projects in this overview 
of Pico-based retro gaming are still in their 
experimental stages, calling for breadboard 
assemblages or requiring you to have PCBs 
custom-made, you can just buy a RetroVGA kit 
at magpi.cc/retrovga. 
Starting at $10 for the bare main PCB, $30 fora 
PCB and gold keyboard-bearing top panel, up to 


It uses different GPIO to VGA connections, $108 for a fully assembled, ready-to-flash unit 

which are documented in the project repository with all components, there are plenty of options 

at magpi.cc/picovga. available, depending on your needs and on how 
Full documentation for RetroVGA itself is much soldering you’re prepared to do. 


available at magpi.cc/retrovgadocs to help you 


of options available, depending 


mThere are plenty n how much soldering youre 


on your needs and O 
prepared to dol 


both assemble RetroVGA and get it 
up and running with a selection of 
emulators or the PicoVGA library, 
and there’s enough detail there to get 
developers up and running 

Currently, you can use MCUME to emulate 
the ZX81, ZX Spectrum, Atari 800, C64, VIC20, 
Atari 2600, Odyssey/Videopac, Colecovision, 
and Atari 5200. MCUME provides an 
effective, but bare-bones emulation 
experience. It can read game files 
from the SD card, giving you access 
to the rich world of C64 and Spectrum 
homebrew and indie releases. The pico- 
zxspectrum emulator is even more capable, 


+ 
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Four retro gaming hardware 
projects to test out 


PICOCART64 


The PicoCart64 is a flash 
cart for the Nintendo N64: a 
device that can hold code to 
be read by the original console 
hardware, allowing you to load o 
your own games and software 

onto an actual N64. 

lt can boot N64 homebrew, which makes it a compelling way of 
accessing the console's rich post-market game ecosystem on real 
hardware, given that the most popular N64 flash carts are both costly and 
often hard to come by. 

Creator Konrad Beckmann says that he set out on the project to find 
out if it’s possible to use Raspberry Pi Pico instead of the FPGAs (field- 
programmable gate arrays) used in most commercially available flash 
carts, already expensive hardware that's become even more rare in the 
face of global chip shortages. 

The PicoCart64 Lite is the project's first functional prototype flash cart, 
capable of loading N64 games, test files, and homebrew. It requires a 
single Raspberry Pi Pico, plus a MOSFET and resistor, and costs less than 
$10 to make. 

The project's GitHub repository includes component lists, PCB 
schematics and, helpfully for those new to having their own PCBs 
fabricated, a link to a comparatively inexpensive service that'll do just that. 

You'll find both hardware schematics and software in the develop 
branch of the PicoCart repository, and active discussion among 
contributors and hardware hackers implementing the tech on the Dubious 
Technology Discord channel. 

Beckmann says that the PicoCart64 is “lowering the barrier, making 
it possible for people to make their own games and run it on actual 
hardware.” Find N64 homebrew titles and SDKs to help you make your 
own at magpi.cc/n64homebrew. 


PETTITT 
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PICO PONG 


magpi.cc/ponggit 


PICO-GB-CART 


If you'd like to channel the spirit of Nintendo's classic handheld a 
bit more directly, you can always turn your Pico into a fully-fledged 
Game Boy flash cart. John Green was inspired by his experience 
making Game Boy emulators to see if he could make a hardware 
emulator with hardware skills he describes as “basic”. 

He used Gekkio's GB-BRK-CART (magpi.cc/gbbrkcart), a Game 
Boy breakout board, to interface with the handheld, learn what 
signals the Game Boy was expecting, and test to see if the Pico was 
fast enough to send I/O signals to it. 

Then, he designed another prototype board that allowed for the 
Pico to be directly soldered to the PBC. It worked, but the way both 
these prototype boards interfaced with the Game Boy was a little 
unreliable, he says: “the Game Boy runs on 5V and the Pico runs at 
3.3V, but after testing various voltage level converters, etc., | could 
never come up with a way of reading/writing data back and forth 
from the Game Boy and Pico whilst keeping the ‘correct’ voltages.” 

The make was fairly challenging: “You would think with the Game 
Boy only running at 4MHz and Pico being able to run at 133MHz base 
that [timing] should be no issue,” Green says, but that didn't take into 
account time for the signal to be decoded by the Pico, get the next 
CPU instruction to send back to the Game Boy, and set the correct 
GPIO pins. In the end, Green found that 133MHz was too slow and Pico 
had to be overclocked to 360MHz. Only one of his ten Picos was able 
to function stably at this speed. 

Green hasn't returned to a project's codebase for a while, but has 
plans for its future, including adding the ability to load game images 
from an SD card. 

You can find 
instructions and software 


for the PICO-GB-CART tD o 
at its GitHub repo, while we ya 
i we ale A0 
schematics for the ed AA 
bespoke PCB created for Wp-ala ls Á? 
the project by HDR can po == muy Al 
be found at magpi.cc/ DO mba mba AS | 
Di mim, met AS. 
rp2040gbcart. D2 mis wie AZ, 
Green's other Pico os sis ml A 
pe om Ad | 
projects include a fighting Ds em im AD y 
game hitbox controller, R “ie snipe 
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software projects, such 
as a Game Boy raycaster, | 


alongside a glimpse at his \ , bas mi 
TT 


professional work in the 
games industry at oxen. 
github.io. 


AN 


FEATURE | MägPi 


YOUMAKETECH PICO GAMEBOY 


magpi.cc/picogb 
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Host HTML games, including Pong, ON 


Pico W and play them over yO 


a 


Last known 
address 


Most DHCP routers 
will reassign Pico 
the IP address it 
had last time; to 
save checking for 
it, assign it a static 
IP address. 


WY A two-player game of 
Pong is served over 
your local network 


ur local network 


ost of the projects we’ve looked at in 
M this feature will work perfectly with 

a standard Raspberry Pi Pico, but it’s 
about time we did something that can take 
advantage of Pico W’s unique networking 
capabilities. Let’s host some web games. 

There are limits to what you can host. Complex 
Twine games throw memory errors, for example. 
But as we’re interested in retro games, we’re in 
luck. To help celebrate Pong’s 50th anniversary, 
here’s a complete beginner’s guide to hosting a 
two-player, HTML5 and JavaScript version of Pong 
on Pico, from installing MicroPython 


Install Thonny 

If you're using any Raspberry Pi 
computer to write to Pico, the Thonny Python 
IDE should already be installed. You'll find it in 
the repositories of other Linux distributions, 
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Nuke it from orbit 


If you start encountering memory errors, or 
need to get rid of files from previous projects 
or experiments, you can use the os . remove 
command to delete files one at a time from 
the REPL interpreter prompt. But if you need to 
comprehensively clear everything, MicroPython 
included, there's a more dramatic option. 
Download flash_nuke.uf2 from 
magpi.cc/flashnuke (direct file download). 
Unplug Pico (if connected), hold down the 
BOOTSEL button, and plug it in to your PC. 
Copy flash_nuke.uf2 over to it, and it'll reboot. 
Don't forget to copy a fresh MicroPython 
nightly build over to it before embarking on your 
next project. 


while Windows and macOS users can download it 
from thonny.org. 


Install MicroPython 

Grab a fresh nightly build of MicroPython 
from magpi.cc/rp2picow. Make sure Pico W is 
unplugged, hold down its BOOTSEL button, and 
simultaneously connect it to your PC. It’ll appear 
as amass storage device. Copy the UF2 file you 
downloaded over to it. Pico W will reboot. 


Prepare Thonny 
Open Thonny. In the bottom right of its 
window, yov’ll see a line of text indicating what 


* 


2 


ya 


interpreter you’ re using. If this does not currently 
say ‘MicroPython (Raspberry Pi Pico)’, click on the 
text line and select that option. 


Scripting a server 

We’re going to use two scripts to get our 
co W intranet game server online: main.py 
s your server code, and secrets.py holds the 
SID and password for your wireless network, 
lowing Pico W to automatically connect and 
tart serving its content whenever it's powered 
n in vicinity of the network’s access point. Our 
cripts are based on MIT-licensed project server 
cripts (magpi.cc/picowledserver) created by 
athan Bustler of Pi Cockpit. Download our 


o 2 


onnn 


nn 


We're going to use 
two scripts to get our 


Pico W intranet game 
server online 


versions of both scripts from our project page at 
magpi.cc/picopongserver. 


Customise your network config 

In Thonny, open our main.py and 
secrets.py scripts, update secrets.py with your 
own WiFi network's SSID and password, then save 
them to your connected Pico W. This is easiest if 
your copy of Thonny is in Regular mode rather than 
the Simple mode it starts in. If you're in Simple 
mode, click the ‘Switch to regular mode’ link at the 


Thonny starts in Simple mode, but 
you'll want to switch to regular 
mode to unlock its full capabilities, 
such as the Save as... menu 


Stop Zoom 
secretspy% indexhtmii« moin py 
import rp2 
inport network 
import ubinasclt 
import nachine 
import urequests as requests 
inport tine 
fron secrets inport secrets 
import socket 


rp2.country('DkE*) 


wlan = network. WLAN(network. STA_IF) 
wlan.actlve(True) 


Clicking on the text on the bottom 
right opens your interpreter 
selector. Make sure ‘MicroPython 
(Raspberry Pi Pico) is selected 


top right of Thonny’s icon bar. In Regular mode, 
use the File menu’s ‘Save as...’ option. 


Just add Pong 

We're going to use Straker’s CC-licensed 
Basic Pong Game (magpi.cc/basicpong). Download 
our mirror of the HTML from magpi.cc/github, 
open it in Thonny and save the file to Pico. You 
can customise this, for example by changing the 
ballSpeed variable to make the ball move slowly. 


07 Serve your balls! 

In Thonny, select the main.py file that you 
saved to Pico, and press the play button. Assuming 
your networking has been correctly configured, 
you'll see lines displaying the device’s MAC and IP 
addresses. Copy the IP address into the browser of 
a computer connected to the same local network. 
Congratulations, you and a friend (or your right 
and left hands) can now play a classic Pong clone in 
your browser. Hl 


MicroPython (Raspberry Pi Pico) 


a 
Further 


experiments 


Try other 
lightweight HTML5 
games and see 
how far you can 
push the Pico. It's 
also a great way 

to provide digital 
props and materials 
for physical games. 
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index.html 


> Language: HTML 


x 001. <!DOCTYPE html> 053. // start in the middle of the game 
002. <html> 054. x: canvas.width / 2, 
003. <head> 055. y: Canvas.height / 2, 
004. <title>Basic Pong HTML Game</title> 056. width: grid, 
005. <meta charset=”UTF-8”> 057. height: grid, 
006. <style> 058. 
007. html, body { 059. // Keep track of when need to reset the ball 
008. height: 100%; position 
009. margin: 0; 060. resetting: false, 
e10. } 061. 
011. 062. // ball velocity (start going to the top-right 
012. body { corner) 
013. background: black; 063. dx: ballSpeed, 
014. display: flex; 064. dy: -ballSpeed 
015. align-items: center; 065. }; 
016. justify-content: center; 066. 
017. } 067. // check for collision between two objects using 
018. </style> axis-aligned bounding box (AABB) 
019. </head> 068. // @see https://developer.mozilla.org/en-US/docs/ 
020. <body> Games/Techniques/2D_collision_detection 
021. <canvas width=”750” height=”585” id=”game”></canvas> 069. function collides(obj1, obj2) { 
022. <script> 070. return obj1.x < obj2.x + obj2.width && 
023. const canvas = document.getElementById( ‘game’ ); 071. obj1.x + obj1.width > obj2.x && 
024. const context = canvas.getContext(“2d”); 072. obj1.y < obj2.y + obj2.height && 
025. const grid = 15; 073. obj1.y + obj1.height > obj2.y; 
026. const paddleHeight = grid * 5; // 80 074. } 
027. const maxPaddleY = canvas.height - grid - 075. 
paddleHeight; 076. // game loop 
028. 077. function loop() { 
029. var paddleSpeed = 6; 078. requestAnimationFrame(loop) ; 
030. var ballSpeed = 5; 079. context.clearkRect(0,0,canvas.width,canvas.height); 
031. 080. 
032. const leftPaddle = { 081. // move paddles by their velocity 
033. // start in the middle of the game on the left 082. leftPaddle.y += leftPaddle.dy; 
side 083. rightPaddle.y += rightPaddle.dy; 
034. x: grid * 2, 084. 
035. y: canvas.height / 2 - paddleHeight / 2, 085. // prevent paddles from going through walls 
036. width: grid, 086. if (leftPaddle.y < grid) { 
037. height: paddleHeight, 087. leftPaddle.y = grid; 
038. 088. } 
039. // paddle velocity 089. else if (leftPaddle.y > maxPaddleY) { 
040. dy: © 090. leftPaddle.y = maxPaddleY; 
041. ); 091. y 
042. const rightPaddle = { 092. 
043. // start in the middle of the game on the right 093. if (rightPaddle.y < grid) { 
side 094. rightPaddle.y = grid; 
044. x: canvas.width - grid * 3, 095. } 
045. y: canvas.height / 2 - paddleHeight / 2, 096. else if (rightPaddle.y > maxPaddleY) { 
046. width: grid, 097. rightPaddle.y = maxPaddleY; 
047. height: paddleHeight, 098. } 
048. 099. 
049. // paddle velocity 100. // draw paddles 
050. dy: 0 101. context.fillStyle = ‘white’; 
est. }; 102. context. fillRect(leftPaddle.x, leftPaddle.y, 
052. const ball = { leftPaddle.width, leftPaddle.height) ; 
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DOWNLOAD 
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e] 


103. 


Hres. 


105. 
106. 
107. 
108. 
109. 


110. 
alo 
112. 
113. 
114. 
1157 
116. 
ZAS 
118. 
119. 


120. 


121. 
122. 
123. 


124. 
1257 
126. 
127. 
128. 
129. 
130. 
131. 


132. 
133: 
134. 
135. 


136. 
137. 
138. 
139: 
140. 
141. 
142. 


143. 
144. 
145. 
146. 
147. 
148. 


context.fillRect(rightPaddle.x, rightPaddle.y, 
rightPaddle.width, rightPaddle. height); 


// move ball by its velocity 
ball.x += ball.dx; 
ball.y += ball.dy; 


// prevent ball from going through walls by 
changing its velocity 
if (ball.y < grid) { 
ball.y = grid; 
ball.dy *= -1; 
} 
else if (ball.y + grid > canvas.height - grid) { 
ball.y = canvas.height - grid * 2; 
ball.dy *= -1; 
J 


// reset ball if it goes past paddle (but only if 
we haven’t already done so) 
if ( (ball.x < 0 || ball.x > canvas.width) && 
!ball.resetting) { 
ball.resetting = true; 


// give some time for the player to recover 
before launching the ball again 

setTimeout(() => { 
ball.resetting = false; 
ball.x = canvas.width / 2; 
ball.y = canvas.height / 2; 

}, 409); 

J 


// check to see if ball collides with paddle. if 
they do change x velocity 
if (collides(ball, leftPaddle)) { 
ball.dx *= -1; 


// move ball next to the paddle otherwise the 
collision will happen again 
// in the next frame 
ball.x = leftPaddle.x + leftPaddle.width; 
) 
else if (collides(ball, rightPaddle)) { 
ball.dx *= -1; 


// move ball next to the paddle otherwise the 
collision will happen again 
// in the next frame 
ball.x = rightPaddle.x - ball.width; 
J 


// draw ball 
context.fillRect(ball.x, ball.y, ball.width, 
ball.height); 


149. 
150. 
151. 
152. 
153. 


154. 
155. 
156. 


157. 


158. 
159. 
160. 
161. 
162. 
163. 
164. 
165. 
166. 
167. 
168. 
169. 
170. 
171. 
172. 
73% 
174. 
175. 
176. 
177. 
178. 
1785 
180. 
181. 
182. 
183. 


184. 
185. 
186. 
187. 
188. 
189. 
190. 
191% 
192. 
193. 
194. 
1957 
196. 
197. 
198. 


// draw walls 

context.fillStyle = ‘lightgrey’; 

context.fillRect(@, 0, canvas.width, grid); 

context.fillRect(0, canvas.height - grid, 
canvas .width, canvas.height); 


// draw dotted line down the middle 
for (let i = grid; i < canvas.height - grid; i += 
grid * 2) { 
context. fillRect(canvas.width / 2 - grid / 2, i, 
grid, grid); 
} 
} 


// listen to keyboard events to move the paddles 
document .addEventListener(‘keydown’, function(e) { 


// up arrow key 

if (e.which === 38) { 
rightPaddle.dy = -paddleSpeed; 

} 

// down arrow key 

else if (e.which === 40) { 
rightPaddle.dy = paddleSpeed; 

} 


// w key 

if (e.which === 87) { 
leftPaddle.dy = -paddleSpeed; 

} 

// a key 

else if (e.which === 83) { 
leftPaddle.dy = paddleSpeed; 

} 

H; 


// listen to keyboard events to stop the paddle if 
key is released 
document .addEventListener(‘keyup’, function(e) { 
if (e.which === 38 || e.which === 40) { 
rightPaddle.dy = 0; 
} 


if (e.which === 83 || e.which === 87) { 
leftPaddle.dy = 0; 
} 
H; 


// start the game 
requestAnimationFrame(loop); 
</script> 

</body> 

</html> 
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main.py 


> Language: Python 


001. import rp2 037. break 
002. import network 038. timeout -= 1 
003. import ubinascii 039. print( ‘Waiting for connection...?) 
004. import machine 040. time.sleep(1) 
005. import urequests as requests 041. 
006. import time 042. # Define blinking function for onboard LED to 
007. from secrets import secrets indicate error codes 
008. import socket 043. def blink_onboard_led(num_blinks): 
009. 044. led = machine.Pin( “LED”, machine.Pin.OUT) 
010. + Set country to avoid possible errors 045. for i in range(num_blinks): 
011. rp2.country( ‘DE’ ) 046. led.on() 
012. 047. time.sleep(.2) 
013. wlan = network.WLAN(network.STA_IF) 048. led.off() 
014. wlan.active(True) 049. time.sleep(.2) 
015. + If you need to disable powersaving mode 050. 
016. + wlan.config(pm = 0xa11140) 051. + Handle connection error 
017. 052. # Error meanings 
018. + See the MAC address in the wireless chip OTP 053. +0 Link Down 
019. mac = ubinascii.hexlify( 054. #1 Link Join 
network.WLAN().config(“mac*),?:*).decode() 055. #2 Link Nolp 
020. print(‘mac = * + mac) 056. #3 Link Up 
021. 057. + -1 Link Fail 
022. # Other things to query 058. # -2 Link NoNet 
023. + print(wlan.config( “channel? )) 059. + -3 Link BadAuth 
024. + print(wlan.config( “essid”)) 060. 
025. + print(wlan.config( “txpower” )) 061. wlan_status = wlan.status() 
026. 062. blink _onboard_led(wlan_status) 
027. # Load login data from different file for safety 063. 
reasons 064. if wlan_status != 3: 
028. ssid = secrets[ ‘ssid’ ] 065. raise RuntimeError( “Wi-Fi connection failed”) 
029. pw = secrets[ ‘pw’ ] 066. else: 
030. 067. print( ‘Connected’ ) 
031. wlan.connect(ssid, pw) 068. status = wlan.ifconfig() 
032. 069. print(“ip = * + status[0]) 
033. # Wait for connection with 10 second timeout 070. 
034. timeout = 10 071. # Function to load in html page 
035. while timeout > 0: 072. def get_html(html_name): 
036. if wlan.status() < 0 or wlan.status() >= 3: 073. with open(html_name, ‘r’) as file: 
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074. 
075. 
076. 
077. 
078. 
079. 
080. 
081. 
082. 
083. 
084. 
085. 
086. 
087. 
088. 
089. 
090. 
091. 
092. 
093. 
094. 
095. 
096. 
097. 
098. 


099. 
100. 
101. 
102. 
103. 
104. 
105. 
106. 
5 107. 
108. 
109. 


html = file.read() 
return html 


# HTTP server with socket 
addr = socket.getaddrinfo(‘0.0.0.0’, 80)[@][-1] 


s = socket.socket() 
s.bind(addr) 
s.listen(1) 


print(“Listening on’, addr) 
led = machine.Pin( “LED”, machine.Pin.OUT) 


# Listen for connections 
while True: 
try: 
cl, addr = s.accept() 
print( ‘Client connected from’, addr) 
r = cl.recv(1024) 
# print(r) 


response = get_html( ‘index.html’ ) 


cl.send(“HTTP/1.0 200 OK\r\nContent-type: 


text/html\r\n\r\n’ ) 
cl.send(response) 
cl.close() 


except OSError as e: 
cl.close() 
print( ‘Connection closed’) 


# Make GET request 

#request = requests.get( ‘http://www. google.com’ ) 
#print(request.content) 

#request.close() 
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secrets.py 


> Language: Python 


001. secrets = { 


002. ‘ssid’: “Enter_your_SSID_here”, 
003. “pw?: ‘Enter_your_Wi-Fi_password_here’, 
004. } 


Retro Gaming 
with Raspberry Pi 


Discover how to set up Raspberry Pi to 
play classic games in the brand new 
version of our retro gaming guide. In this 
164-page book, you'll learn how to build 
a portable games machine, assemble a 
full-sized arcade cabinet, and emulate 
classic computers and consoles. 
magpi.cc/retrogaming 
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MagPi, Philis a 
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editor with a focus 
on technology. 


@philkingeditor 


| You'll Need 


» Raspberry Pi 
Pico W 


» Anvil account 
(free tier) 
anvil.works 


> RGB LED 
> 3x 330Q resistors 


> 4 x male-male 
jumper wires 


> Figure 1: The wiring 
diagram for the mood 
lamp circuit using an 
RGB LED 


Pico W IoT with 
Anvil: Mood lamp 


Create a colour-changing RGB LED mood lamp controllable from a web app 


ith built-in wireless connectivity, 
W Pico W is ideal for creating Internet of 

Things (IoT) projects. To make it even 
simpler, Anvil has released a Pico W IoT toolkit to 
enable you to connect easily, and securely, to web 
apps you create on the Anvil platform. There’s a 
drag-and-drop web UI builder, built-in database, 
user authentication, email integration, HTTP APIs, 
and more - and it all talks to your Pico W. 

By using Anvil’s special UF2 firmware image, 

you can code programs on Pico W in MicroPython 
as normal, with a few extra lines to connect to 
Anvil, then create a web app on the Anvil site 
which can send and receive data to/from your 
Pico W program. In this tutorial, we’ll be showing 
you how to control the colour of an RGB LED using 
sliders in an Anvil web app. 


Install the firmware 

To be able to link your Pico W to the Anvil 
framework, you’ll need to use a special firmware 
file. Go to magpi.cc/anviluf2 and download the 
latest ‘complete’ UF2 file. (If you want to avoid 
overwriting any existing files on Pico W, use the 
‘firmware-only’ version.) 


..o.o...s. 


. 
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As usual, hold Pico W’s BOOTSEL button while 
connecting it to a computer via USB, then drag 
the UF2 file to the mounted ‘RPI-RP2’ volume. 
Once it’s copied across, Pico W will automatically 
reboot and reappear as a volume called ‘Pico W’. 


Connect to WiFi 

With Pico W connected to your computer, 
open up the Thonny IDE and make sure the Python 
interpreter (shown at the bottom right) is set to 
“MicroPython (Raspberry Pi Pico)’. The main.py 
file on Pico W will run automatically, so you will 
need to stop it by pressing the Stop icon. Open the 
boot.py file and enter your wireless router’s SSID 
(name) and password at the top. 


WIFI_SSID = "<put your network name here>" 
WIFI_PASSWORD = "<put your wifi password 
here>" 


Now when Pico W reboots, it'1l automatically 
connect to your wireless network. 


Wire up the circuit 

Place your Pico W on one end of a 
breadboard, as in Figure 1. Add your RGB LED at 
the other end with each leg placed in a different 
row. It has four legs, the longest of which should 
be the ground connection — use a jumper wire to 
connect that to a GND pin on Pico W. 

As usual with LEDs, you should use resistors to 
limit the maximum current to avoid possible LED 
burnout. We’ve used three 330 Q resistors placed 
over the central dip of the breadboard to connect 
the LED’s R (red), G (green), and B (blue) legs to 
jumper wires connected to GPIO pins 13, 14, and 15 
respectively on Pico W. 


The Pico W 

runs standard 
MicroPython code 
that links up to 
the Anvil web app 


An RGB LED is wired to 
Pico's pins and its colour 
is set by the web app 


Note: Our RGB LED’s legs were in the order R, 
GND, B, and G, but yours may differ. 
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Zhuzh it up 


Make your web 


Test the circuit 

To make sure everything is connected 
correctly, we’ll run a simple program on Pico W. In 
the Thonny IDE on your computer, make sure the 
Python interpreter (shown at the bottom right) is 
set to ‘MicroPython (Raspberry Pi Pico)’. 

Open a new file and add the code from the 
RGB_test.py listing (overleaf). Run it and the RGB 
LED should turn red, green, and blue in turn. If the 
colours are in the wrong order, you will need to 
swap over the relevant jumper wires. 


Write the code 

Now let’s write the MicroPython code 
for our RGB LED ‘mood lamp’, as seen in the 
mood_lamp_sliders.py listing. The top line, 
import anvil.pico, enables Pico W to connect to 
Anvil’s servers. The second, import uasyncio as a, 
sets up an asynchronous scheduler for running 
concurrent functions. We also import the Pin and 


app funkier by 
adding icons, 
images, or 
altering the 
colour scheme. 
We changed 

the slider text 
‘row_background’ 
colours to red, 
green, and blue. 


The web app created on 
Anvil features sliders to 
control the colour of the 
RGB LED mood lamp 


PWM classes from the machine library so we can 
control our RGB LED from the GPIO pins. 

Further down is a line starting UPLINK_KEY =. 
This is where you will later need to paste the uplink 
key for the web app you create on Anvil so your 
Pico W program can link to it. At the bottom of the 
program is a line to connect using it. 


m Connect easily, and securely, 
to web apps you create on 
the Anvil platform Ø 


TopTip è 


Next, we create three variables to set the levels 
Autorun code 


of the red, green, and blue parts of the RGB LED. 


We then set up the PWM pins as in our test code. 
To make your 


Pico W code run 
automatically 
upon bootup, save 


Call the decorator 

In our code, we have three functions: one 
each for controlling the red, green, and blue parts 
of the RGB LED. Before each, we add a “decorator” 
and also add async at the start of the line defining 
the function; for instance: 


it as main.py. If 
you already have 
a main.py file, you 
may want to save 
that under another 
name first. 
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Connecting to Anvil... 


Connected 
Authesticated to app FXQLEN2TOQUAQUTE 


Maret yoon [aspran Pi Pico], 


A When run, the Pico W 
MicroPython code 
will connect to the 
linked Anvil web app 


@anvil.pico.callable_async 
async def red(slider): 


This lets our connected Anvil web app know 
that this function is available to call from the web. 


DOWNLOAD 
THE FULL CODE: 


© magpi.cc/github 


RGB_test.py 


> Language: MicroPython 


001. from machine import Pin, PWM 

002. from utime import sleep 

003. 

004. + Set PWM pins to control R, G, and B LEDs 
005. pwm13 = machine.PuM(machine.Pin(13)) 
006. pwm14 = machine.PWM(machine.Pin(14) ) 
007. pwm15 = machine. PWM(machine.Pin(15)) 
008. pwm13.freq(1000) 

009. puwm14.freq(1000) 

010. puwm15.freq(1000) 

011. 

012. # Loop to light R, G, B LEDs in turn 
013. while True: 


014. # Red 

015. pwm13.duty_u16(65535) 
016. sleep(1) 

017. pwm13.duty_u16(@) 
018. sleep(1) 

019. # Green 

020. pwm14.duty_u16(65535) 
021. sleep(1) 

022. pwm14.duty_u16(@) 
023. sleep(1) 

024. # Blue 

025. pwm15.duty_u16(65535) 
026. sleep(1) 

027. pwm15.duty_u16(@) 
028. sleep(1) 
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We’ll be sending a value to it, set by a slider in the 
web app, which will set the level of that colour. As 
we're using values from O to 255 for the slider, we 
multiply it by 256 to turn it into an unsigned 16-bit 
integer (O to 65535) for the PWM level setting. 


07 Design the web app 
Go to anvil.works and sign up for a free 
account. We want to use slider controls for our 
lamp, which aren't available as a standard Anvil 
component, so we’ll open up a demo app containing 
the Sliders library: go to anvil.works/library/slider 
and click ‘Open in Anvil’. 

The Sliders demo app only has two sliders and 
we want three, for red, green, and blue. From the 
right-hand Toolbox panel, drag a Slider custom 
component to just above the Reset button. Now 
select an existing ‘Value:’ element, press CTRL/ 
CMD + C to copy it, and paste it under the new 
slider with CTRL/CMD + V. Copy and paste a ‘1’ 
component to the right of it. 

Click on each ‘Value:’ element in turn and 
change the text for it (in the right-hand Properties 
panel) to “Red:”, ‘Green:’, and ‘Blue:’ respectively. 
Set each ‘1’ text element to “0”. Also, set the “Blue:” 
element name to ‘label_6, and the accompanying 
“o” element name to ‘label_7’. For each slider, set 
the ‘slider_max’ value to 255. 


Enable server uplink 

Click the ‘+’ button at the bottom left and 
select Uplink, then click Enable next to Server 
Uplink. This will generate a Server Uplink Key 
(ignore the client key) for the app which you 


A The cover from a PIR sensor makes a decent 
diffuser for the light from the RGB LED 


should paste into line 5 of your MicroPython code 
on Pico W so it can connect to it. 


Adjust web code 

We need to alter the web app code so the 
setting for each slider is sent to the red, green, or 
blue function in your Pico W program. Click on the 
Code tab and add the following lines (indented) to 
the slider1_change function: 


anvil.server.call_s("green",self.slider_1. 
level) 
pass 


Note that slider 1 is the middle one, which we’ve 
assigned to green. Similarly, for slider2_change, 
add the following two lines (indented): 


anvil.server.call_s("red",self.slider_2. 
level) 
pass 


Add a similar new function for slider 3: 


def slider_3 change(self, **event_args): 
self.label_7.text = self.slider_3.level 
anvil.server.call_s("blue",self.slider_3. 
level) 
pass 


Finally, add these lines to the reset_btn_click 
function in the web code: 


self.slider_3.level = @ 
self.label_7.text = 0 
anvil.server.call_s("red",0) 
anvil.server.call_s("green",0) 
anvil.server.call_s("blue",0) 
pass 


Run both apps 

We're now ready to roll. First, run your 
Pico W program in Thonny. You’ll see messages 
in the Shell pane to show it connecting. Once it 
has, run your Anvil web app. You can now move 
the sliders to adjust the red, green, and blue 
components of your RGB LED to alter its shade. 

To make it a little more effective, you may want 

to diffuse the LED’s light. We simply placed the 


TUTORIAL | MägPi ME 


mood_lamp_sliders.py 


> Language: MicroPython 


001. import anvil.pico 

002. import uasyncio as a 

003. from machine import Pin, PWM 
004. 


DOWNLOAD 
THE FULL CODE: 
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005. UPLINK_KEY = "<put your Uplink key here>" 


006. 


007. # We use the LED to indicate server calls and responses. 


008. led = Pin("LED", Pin.OUT, value=1) 
009. 

010. # Set LED levels to zero 

011. redlevel = ð 

012. greenlevel = ð 

013. bluelevel = ð 

014. 

015. # Set PWM pins for R, G, and B LEDs 
016. pwm13 = machine.PWM(machine.Pin(13)) 
017. pwm14 = machine.PWM(machine.Pin(14)) 
018. pwm15 = machine.PWM(machine.Pin(15)) 
019. pwm13.freq(1000) 

020. pwm14.freq(190909) 

021. pwm15.freq(1000) 

022. 

023. # Red LED control 

024. @anvil.pico.callable_async 

@25. async def red(slider): 


026. redlevel = slider * 256 
027. pwm13.duty_u16(redlevel) 
028. 


029. # Green LED control 
030. @anvil.pico.callable_async 
031. async def green(slider): 


032. bluelevel = slider * 256 
033. pwm14.duty u16(bluelevel) 
034. 


035. # Blue LED control 
036. @anvil.pico.callable_async 
037. async def blue(slider): 


038. greenlevel = slider * 256 
039. pwm15.duty_u16(greenlevel) 
040. 


041. + Connect the Anvil Uplink. In MicroPython, this call 


will block forever. 
042. anvil.pico.connect(UPLINK_KEY) 


translucent plastic cover from a PIR sensor 

over it, which works fairly well. You now have a 
web-controlled mood lamp! Next time, we’ll be 
reading Pico W sensor data in an Anvil web app. E 
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sean.co.uk 


| You'll Need 


> Some MP3 music 
files 


> Some MP3 jingles 
> Internet connection 


> Display-O-Tron HAT 
(optional) magpi.cc/ 
displayotron 


> PiGlow (optional) 
magpi.cc/piglow 


Raspberry P1 Radio: 
Add a DJ and jingles 


On air in 3, 2, 1... You're listening to Raspberry Radio, the only 
Station that plays your own music, all day and all night 


ith Raspberry Radio, you’re guaranteed 
W to hear your favourite songs. The 
program creates a virtual DJ, who 
plays your MP3s at random, but introduces 
each one with some information about it. Every 
eight songs, there’s a break for the news and 
weather. For an extra touch, you can adda 
Display-O-Tron HAT to show the artist and track 
name while it plays, like a DAB radio does. This 
project shows you how to make your Raspberry 
Pi speak, how to access the metadata in an 
MP3 file, and how to play music from Python. 


Prepare your files 

Raspberry Radio makes use of the 
rr_newsreader.py program from Part 1 in this 
series (see The MagPi issue #121, magpi.cc/121). 
Put rr_newsreader.py in the same folder as the 
raspberry_radio.py program from this issue. 
That folder should also have two subfolders: 
one called music, and another called jingles. 
You can download all the code for this project 
at magpi.cc/raspradio. 


Install Python modules 

For text-to-speech, we’re using pyttsx3. 
Playsound will play our MP3s. Meanwhile, tinytag 
will read the metadata of the music files. By pulling 
out the artist name, song title, album, and year, 
we can get the virtual DJ to say something smart 
about each track before it plays. You also need to 
install the modules that the rr_newsreader.py 
program requires, if you didn’t do that last issue. 
Open a Terminal window and enter the following 
commands at the prompt to download and install 
the modules, along with text-to-speech and media 
player software: 
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pip install pyttsx3 tinytag playsound 
requests feedparser 
sudo apt install espeak mopidy 


Gather music and jingles 

Raspberry Radio uses your own MP3s, 
which you should copy to the music subfolder. 
If you don’t have an MP3 collection, lots of 
artists make their music available for free 
download on Bandcamp (find the author’s at 
magpi.cc/artificial). To make it feel like real radio, 
we will top up the jingles folder. We recommend 
Music Radio Creative (magpi.cc/freejingles), which 
has lots of themed collections for free download. 
It’s OK if your music and jingles folders have 
subfolders. Find a news jingle and store it beside 
the raspberry_radio.py program, not in the jingles 
folder. Call it news_jingle.mp3. We’ll play it when 
the news is read out. 


A Using Pygame (instead of Playsound) and a PiGlow (instead 
of the Display-O-Tron), you can flash the lights while music 
plays. See the code at magpi.cc/discolights 


— 


The screen shows the artist 
and song title, like a DAB radio 
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You can connect to any 
speakers, such as these 
portable iPod speakers 


INFORMATIVE PHOTOVISUAL TECHNOLOGY 


Edit the jingles 

Radio and podcast jingles often have a slow 
fade out on them, because the (human) DJ speaks 
over the end of them. You can edit out silence or 
cut an excessive fade using Audacity. Install it from 
the Terminal using sudo apt install audacity. 
Yov’ll find it in the Sound & Video category of 
your desktop menu. Open a jingle, and click the 
Play button in the top left to see where the fade 
becomes inaudible. Click and drag from that point 
to the end of the sound, and then use CTRL+X to 
cut the selected audio. Select File > Export to save 
your trimmed MP3 file. 


Make Raspberry Pi speak 

The instructions that make the computer 
talk are spread out in the program, so here’s a 
simple demo that brings them all together. Enter 
these instructions in the Python Shell: 


import pyttsx3 

voice = pyttsx3.init() 
voice.say("hello") 
voice.runAndWait() 


The voice.say() function queues up speech, but it 
isn't spoken until the voice. runAndWait() function 
runs. You can optionally set the rate (or speed) of 
the speech. In line 62, we chose 170. It's a bit slower 
than natural speech, so it’s easier to understand. 
Lower numbers are slower still, and higher numbers 


m You can edit out silence or 
cut an excessive fade El 


are faster. We packaged up the speech instructions 
in the output() function at the start of the program. 
It also prints the messages to the screen. 


TopTip è 


Be selective 


Indexing the 
files takes some 
time, so choose 
your favourite 
tracks and 
albums, rather 
than pointing 
the program 

at your entire 
¡Tunes library. 


Choose your DJ 

There are several English accents you can 
choose from, including en-scottish, english-north, 
english_rp, english_wmids, english-us, en- 
westindies. As you can see, some use hyphens and 
some use underscores in their names. RP is short 
for received pronunciation and is the accent you 
hear on old BBC news reels. You can change your 
DJ's voice by adding an instruction like this: 
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raspberry_radio.py 


DOWNLOAD 
THE FULL CODE: 


> Language: Python 3 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 


028. 
029. 
030. 
031. 
032. 


033. 
034. 
035. 
036. 
037. 


038. 
039. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 


049. 


050. 


051. 
052. 
053. 
054. 
055. 
056. 


# Raspberry Radio from The MagPi by Sean McManus 

import rr_newsreader, random, pyttsx3, os, sys 

from playsound import playsound 

from tinytag import TinyTag 

import dot3k.1cd as lcd + Remove if not using Display-0-Tron 


def output(text): 
print(text) 
voice.say(text) 
voice.runAndWait() 


def broadcast_news_and_weather(): 
playsound('news_jingle.mp3') 
date = rr_newsreader.get_date() 
output(date) 
news_headlines = rr_newsreader.get_news() 
for line in news_headlines: 
output(line) 
weather_report, temperature = rr_newsreader.get_weather() 
output(weather_report) 


def index_directory(path, songs, perform_checks): 
print("Processing directory:", path) 
for entry in os.listdir(path): 
path_plus_entry = os.path.join(path, entry) 
if os.path.isdir(path_plus_entry): 
index_directory(path_plus_entry, songs, 
perform_checks) 
elif entry.endswith('.mp3'): 
tag = TinyTag.get(path_plus_entry) 
if perform_checks == False or \ 
(tag.title is not None and Y 
tag.genre not in ["Books & Spoken", 
"Christmas"] and \ 
tag.duration < 6000 and \ 
"live" not in tag.album and \ 
"live" not in tag.title): 
songs. append(path_plus_entry) 
print("Track added:", tag.title, "by", 
tag.artist, "from", tag.album) 
return songs 


def play_songs(number_of_songs): 
for _ in range(number_of_songs): 
if random.random() > 0.4: 
jingle_to_ play = random.choice(jingles) 
playsound(jingle_to_play) 
song_to_play = random.choice(songs) 
tag = TinyTag.get(song_to_play) 
dj_says = random.choice( 
[ "What were you doing in {tag.year}? 
Here's what {tag.artist} was up to.", 
f"Here's a {tag.year} track from the album 
{tag.album}.", 
f"Fancy some {tag.genre} music? Here's { 
tag.artist}." 


1) 
output(dj_says) 
DAB_display = (tag.artist + ' ' * 16)[:16] \ 


+ tag.title[:32] 
1cd.clear() 
lcd.write(DAB_display) 


© magpi.cc/raspradio 


voice.setProperty('voice', 'english_wmids') 


If you want to change the voice, we suggest you add 
the instruction near the end of the program, after 
you set its speed. You can change the voice back by 
setting it to 'default'. 


07 Playing MP3s 
There are several different ways you can 
play music tracks from Python on Raspberry Pi. 
We're using the playsound module because it’s 
easy to use, and the code is concise. You can play 
an MP3 using just two lines of code: 


from playsound import playsound 
playsound('filename.mp3' ) 


By default, playsound pauses the program until the 
sound has finished. That stops our DJ’s speech and 
the audio files clashing. You can pass an additional 
value of False to start the sound playing without 
pausing the program. 


Indexing the music files 

The index_directory() function creates 
a list containing all the music files in a directory 
and its subfolders. It might look familiar: we used 
a similar function to index images for ArtEvolver 
in issue 119. This time, we pass an additional True 
or False value to the function to say whether we 
want to perform quality checks. The quality checks 
ensure that songs are added that will work well on 
the radio. First, it checks they have a song title. 
Then, it excludes tracks that are in the Christmas 
or Books & Spoken genres, songs longer than 6000 
seconds, and songs with ‘live’ in the album or track 
name. It’s distracting when bursts of applause 
break through, although we do sacrifice some 
songs along the way (such as 


057. playsound(song_to_play) 

058. 

059. songs = index_directory("music", [], True) + 
folder for music 

060. jingles = index_directory("jingles", [], False) 
# folder for jingles 

061. voice = pyttsx3.init() 

062. voice.setProperty('rate', 170) 

063. while True: 

064. broadcast_news_and_weather() 

065. play_songs(8) 
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Speed up 
indexing 


You can speed 
up the indexing 
by deleting or 
commenting 
out the print 
statements 

in the index_ 
directory() 
function. 


P This twelve-second 
jingle only has 
between six and 
seven seconds 
of audible sound. 
Using Audacity, you 
can trim it 


Freebie Freebie 
Feel Good New Music 
Radio Radio d 
Jingles Jingles Ad 
mo mone _ enn wone 
Freebie Freebi f 
Jingles for End Show 
World Radio Radio SS 
Broadcasts Jingles Se 
f 
| READ MORE READ WORE 


A Music Radio Creative provides lots of free jingle packs, 
made with professional voiceover artists and high- 
energy sound effects 


Live to Tell by Madonna). When indexing the music 
folder, we want to make sure the songs follow 
those rules. The jingles don’t need metadata 

(and probably don’t have it), so we turn off the 
quality checks for them. 


Extracting the music metadata 

The tinytag module is used to extract 
metadata from the MP3 file in line 46. We can 
discover the song title, artist, album, year, genre, 
and duration. We’ve assumed that if the song title 
is present, then other metadata will be too. You can 
also find the composer, which is well-supported 
for classical music, but less so for pop and rock. 
The more accurate and the more complete your 
metadata is, the more authentic the DJ will sound. 


Creating the DJ banter 

The dj_says variable contains a randomly 
chosen phrase for the DJ to say before the song 
plays. We use f-strings to insert one or more tags 
into the phrase. Only a few examples are included 
here. The more you add, the less repetitive your 
DJ will sound. Have fun with it: it’s easy to make 


56 | magpicc | Raspberry Pi Radio: Add a DJ and jingles 


robotic announcements like “This is Prince. Here’s 
Purple Rain.” It sounds more like a real DJ to say 
something like “What were you doing in 1984? 
Here’s what Prince was up to!” 


Making the DAB display 

The best feature of our DAB radio is that it 
shows us the track and artist that’s playing, so if 
you miss the DJ’s introduction, we can still find out 
what it is. We’ve used a Display-O-Tron HAT to 
show the artist name and song name. If you don’t 


m There's lots you can do to 
extend this project Ø 


have one, you can delete lines 5, and 53 to 56. The 
display is 16 characters wide and has three rows. 
The code takes the artist name, adds 16 spaces, and 
then keeps only the first 16 characters using [:16]. 
That ensures the artist name fills the first line and 
doesn’t spill over. The song name is cut to its first 
32 characters so it doesn't wrap from the bottom 
line to the top. 


Build on it! 

There’s lots you can do to extend this 
project. You could remove songs from the list when 
they're played, so they don’t get played twice. If 
you use Pygame to play the music instead of the 
playsound module, you can display animations 
while the music plays. The downside is that 
Pygame doesn’t support MP3 files, so you'll need to 
convert your files to the OGG format. You can find 
some example code to cycle through the lights on a 
PiGlow add-on board at magpi.cc/discolights M 
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Rob Zwetsloot 


If Rob had a 

nickel for every 
time he's made 

a Luigi's Mansion 
Poltergust, he'd 
have two nickels, 
which isn't a lot, but 
it's weird that it's 
happened twice. 


magpi.cc 


| You'll Need 


> 3D printed parts 


> Small motor 


v 


NeoPixel ring 
magpi.cc/neopixel16 


> NeoPixel strips 
> Mobile battery 
> Wires 

» Dremel 

> Spray paint 

> Leather strap 


» Side release buckles 


v 


Corrugated pond 
hose 


Various nuts and 
bolts 


v 


> Glue gun 


» Soldering iron 


Build your own 
Poltergust G-00 


Construct a 3D-printed, ghostbusting vacuum from Luigi's Mansion 3 
with a Raspberry Pi Pico to make it extra cool 


ooking for a cool costume accessory this 
L Halloween to really make your costume 

stand out? Pair this 3D-printed vacuum 
cleaner with an over-the-counter Green Plumber 
costume and you have a thematically correct 
costume that won’t break the bank. 

The Poltergust G-00 is the tool of choice of 
Luigi in Luigi?s Mansion 3, and we thought we’d 
jazz it up with a Raspberry Pi Pico with lights and 
motors and more. It’s moustache time. 


Print your vacuum cleaner 

In the past, Luigi’s Mansion Poltergusts 
were easily made with old vacuums off of eBay. 
Just get one and you’ re good to go! However, the 
developers cheated a little bit with the Poltergust 
G-00 and, in this case, it is much easier and 
accurate to 3D-print one. The version available 
here by Cryzzgrantham is really well put together 
and free: magpi.cc/poltergust1. However, the 
handle and nozzle are quite small. If you'd like 
a bigger model, we used the one from Double A 
Cosplay on Etsy here: magpi.cc/poltergust2. It 


A The parts are ready to print but, if you have experience 
with 3D printing, it doesn't hurt to play around 
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uses fewer parts, so it’s not as easily customisable 
without further editing or power tools. 


Clean up your vacuum 

The tolerances on these prints can be quite 
tight, and 3D printing isn't always perfect, so test 
out the part fits after printing. We took a rotary 
tool to the tyres, fan housing, and hose connector 
to make sure they all fit fine. The main vacuum 
body can slot together very nicely and mostly hold 
by friction, but be prepared to add hot glue later. 

We made the fan housing larger than needed, as 
we plan to have the fan spinning when a trigger is 
pulled on the nozzle section. 

As for the nozzle section trigger — if you use the 
smaller handle, the trigger on that can be more 
easily rigged to be depressed. On the larger one, we 
drilled a couple of holes into the trigger housing so 
we could add a button, with wires going through 
the hose section. 


Smooth your vacuum 

Depending on your level of time and care 
for detail, you can now spend a couple of days 
getting the prints to look very smooth. There are 
many ways to do this; however, the tried and true 
method of applying a thin layer of gesso, sanding 
it down, and then repeating until the surface is 
smooth is great as it also holds paint very well. 

You can use various materials to fill the gaps on 

the main vacuum case as well, such as using a 3D 
print pen to add similar material, or some kind of 
Polyfilla works well. Do this before you start your 
gesso layers, though. 


The tank section hides 
some of the wires and the 
connectors for the straps 


Paint your vacuum 

Prime, paint, topcoat. For our vacuum, we 
went with a grey primer so that some of the edge 
details would stand out more. A couple of coats 
of that all over and allowed to dry will allow the 
paint to adhere better. Luckily, most of the bits 
are separated by colour, and you just need red, 
black, and silver for them. Two or three coats of 
each colour is a good idea. For the alternate handle, 
we painted it all silver first, let that dry, and then 
used masking tape to cover the bits we wanted to 
remain silver before going over it again with black. 
Use a craft knife to trim the tape to get sharper 
edges on the paint. 

After that's all done, a clear or gloss topcoat will 
finish it off. We suggest gloss to match the game. 
Remember to do all of this outside or in a well- 
ventilated room. 


You can use various 
materials to fill the gaps 
on the main hoover case 


Build a test circuit 

It’s always a good idea to test your circuit 
before installing it into any project. If you follow 
along to Figure 1, it shows you how to wire up 
your Circuit to a Pico on a breadboard. All the LEDs 
can be powered off of the 5 V pin on Pico, as it 
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The insides of the wheels are lit 
up with a ring of NeoPixels and 
‘rotate’ when the trigger is pulled 


TEN 


gets power directly from whatever powers Pico. 
However, a resistor is very useful to make sure 
they don’t draw too much power. Eventually you’ ll 
need to install these components, and Pico, into 
the vacuum housing at the bottom. You can either 
solder them onto Pico, or just glue the breadboard 
into there for easy maintenance. 


Installing the code 

With the Pico circuit set up, you can 
start testing the code. Download the code 
from magpi.cc/poltergust and then head to 
magpi.cc/circuitpython. Here, we’re going to 


Figure 1 The components are arranged in sections to make 
separation easier. Bottom left is the handle, bottom right is the 
tank, top right is the wheels, and then the motor is on its own 
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MägPi 


Warning! 
Power Tools 


Make sure you are 
careful when use rotary 
tools, drills, or power 
sanders when modifying 
3D prints 


Top Tip 


3D printing 


We used an 8% 
infill on the print, 
and clear PLA 
for the tank as 
well. While not 
very smooth, it 
does give a nice 
eerie glow. 


ATTE 
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We used a mixture 
of airbrush and 
canned spray paints 
to colour the parts 
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Expanding 
foam 


If parts of your 
print aren't great, 
you can easily 
fix it with an old 
cosplay trick: 
expanding foam. 


| Apply it, let it dry, 


carve it witha 
knife then, after 
about 24 hours, 
you can sand 

it down. 


Always check the fit 
of 3D printed parts 


download the files needed to allow Pico to run 
using CircuitPython, which has some fancy LED 
animations we're going to use. You?1l need to then 
hold the BOOTSEL button down on Pico before 
plugging it into your PC and then dropping the 
CircuitPython UF2 file onto the drive that pops up. 


It will disappear and then come back as CIRCUITPY, 


where you can then add the code.py file from the 
code bundle you downloaded. 

Finally, put the .mpy MicroPython library files 
into the folder lib on Pico. 


Customise your code 

| The Poltergust code has two states: idle and 
active. By this we mean it will behave a certain way 
when turned on and nothing is happening (idle), 


Build your own Poltergust G-00 


and with a button you’ll be able to change the 
behaviour of LEDs and a motor (active). 

The LEDs on the handle and wheels are linked so 
only require one pin, and the tank glows whatever 
is happening. The motor has been turned off in 
the code and you should be careful if using it. The 
throttle is set low so you can test it out yourself 
without making it go dangerously fast. 

You can also change up the number of LEDs on 
the first line of each section. 


| Install your electronics 

| This specific print has a couple of hollow 
support rods that run through the body, and holes 
that access the wheels as well. These are perfect for 
running wires through. Run the handle LED wires 
down the side that fits to the hose connector, and 
the wires for the tank light on the other side. The 
tank is fairly enclosed, so use your judgement on 
where to glue those LEDs. Stick the NeoPixel circles 
to the inside of the wheel spokes and run the wires 
to the main empty compartment on the bottom. 
You just need to hook it all into Pico via soldering 
or with a breadboard. 


| Start construction 
$ | Two 50cm leather straps, cut in half, have 
been attached via 5mm nuts and bolts so they hold 


A table full of Pico-powered projects includedour own 
Poltergust, glowing throughout the day 


firm in the housing and turn as well. Slot the side 
clasp buckles through them on the other end. A lot 
of the rest of the vacuum cleaner comes together 
with friction. However, parts like the wheels, 
wheel rim, tank, etc. need to be hot-glued down. 

In our build, we removed the inner wheel and inner 
fan section so that we could more easily add the 
electronics. These are the circles with the pegs 
sticking out of the middle. 


The LEDs don't take up a 
huge amount of current, so 
a decent mobile battery will 
easily last you a long time 


Finish construction 

We’ve run the wire for the handle LEDs and 
button through the hose and now need to stick all 
of that to the handle, and then seal the hose to 
both ends. The bigger handle is made from four 
pieces, which all slot together quite nicely without 
gluing. However, if you don’t need to take it apart 
again, you could always use glue. 


Finish the straps 
Put the vacuum on and attach the side 
clasps — you should be able to figure out how much 


MägPi 


magpi.cc/poltergust 


Don't forget the Luigi 
costume to go with it! 


of the leather you can snip off. We suggest doing it 
from the top buckle so that the buckles themselves 
sit high on your chest, like in the game. 

Once that’s done, you can sew the ends together 
on all the straps, or use glue — the glue may not 
hold super-well on leather or pleather, though. 


Powering and testing 

We had a USB cable dangling from the 
hole in the back of the case connected to a mobile 
battery in the back pocket of our dungarees. 
Plugging it into that should have the full system 
turn on and start glowing and spinning and such. 
Test out the button to make sure it works properly. 
The LEDs don’t take up a huge amount of current, 
so a decent mobile battery will easily last you a 
long time — we went a whole day with barely any 
loss in power or light! 
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A stitch in code 


The intriguing relationship between the fibre arts and coding 


gH 


Nicola King 


@holtonhandmade 


Nicola King is a freelance 
writer and sub-editor. 
She firmly believes that 
purchasing arts and 
crafts goodies, and 
actually sitting down 

and making something, 
are two completely 
different pastimes. 


Above % 

Fibre arts have a lot in 
common with coding, 
as we shall explain 


ave you ever considered how 

a knitting or a crochet pattern 
resembles coding, and the many 
parallels that exist between the 
fibre arts (an umbrella term which 
includes knitting, crochet, spinning, 
weaving, and yarn dying, to name but a few) and 
coding? These two seemingly unrelated fields have 
an interesting history together and, in this article, 

we will take a look at the fascinating similarities that 
really illustrate how much they have in common — 
spreading, we hope, an appreciation of the fact that 
coding and the fibre arts have many more similarities 
than you may ever have previously considered. 


A CLOSE-KNIT RELATIONSHIP 

Let's begin with a little history, which illustrates how 
coding/programming and the fibre arts are entwined. 
To see one of the most famous examples of this, 

we can simply look at the Jacquard loom, patented 

in 1804 by French weaver Joseph-Marie Jacquard. 
The Jacquard system was way ahead of its time, 

and enabled unskilled workers to weave intricate 
patterns easily: the central principle being the use of a 
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chain of interchangeable punched cards. In weaving, 
a single weft thread is passed over and under a set 
of warp threads. Before this invention, workers had 
to manually raise and lower wrap threads in order 

to create any kind of fabric pattern, and this was an 
extremely slow process. 

The cleverly designed cards of the Jacquard loom 
were fed into the Jacquard mechanism at the top 
of the loom and had small holes punched in them, 
which held the instructions for the weaving pattern. 
They basically controlled which warp threads should 
be raised to allow the weft to pass underneath. 

So, this was a very early example of instructing a 
machine to carry out an automated process, using 
a binary system (with either a punched hole, or no 
punched hole), where the information could be read 
by the loom and reproduced as required. The use of 
the replaceable punched cards to control a sequence 
of operations is widely held as an important step 

in the history of computing, as Charles Babbage 
(1791-1871) was inspired by the Jacquard loom's 
use of punch cards to program his Analytical Engine 
of 1837, considered by many as the first modern 
computer design. So, we can begin to see a link 


There is a stitch in crochet called C2C or ‘corner to 
corner’, and each C2C stitch basically creates a small 
square or block. This means that C2C is a handy stitch 
to know if you want to design a pixel crochet blanket for 
example (also known as graphghans — afghans made 
from graphs), made up of a series of squares where 
each square represents one pixel of the image. You 
could write your own simple pattern for this on a piece 
of graph paper and then stitch it up. Or, you could use a 
website such as Stitch Fiddle (hsmag.cc/PixelCrochet) 
and create your chart there, where you can upload a 
picture to the site, or create a new design yourself. C2C 
is similar to how computers store images in grids of 
coloured squares. 

What we are also illustrating here is that crocheters 
and knitters are very happy to use tech help, including 
websites and apps, in their designs if it makes the 
process easier — İs your image of the average knitter 
or crocheter evolving at all? It's not just about the yarn 
these days... 


here between the two, on first sight, seemingly very 
different worlds. 


ILLUSTRATIONS OF CRAFTING CODE 


Let's now look more closely at the parallels between 


coding and the fibre arts, and perhaps the easiest 
thing to do to illustrate these is to take a look at 
some very simple patterns which, when knitted 
and crocheted, will produce the swatches shown in 
Figures 1 and 2, respectively. 


SIMPLE KNIT PATTERN 

CO 16 stitches 

R1 — P2, [K5, P2] to end of row 

R2 — K2, [P5, K2] to end of row 

R3 - P2, *K2tog, YO, K1,YO, SI1, K1, PSSO, P2; 

rep from * to end of row 

R4 — Repeat R2 

Repeat R1 — R4 until work measures 10cm 

in length 

Bind off 
(Abbreviations: CO — Cast On, R — Row, K - Knit, P 
— Purl, K2tog — Knit two stitches together, YO — Yarn 
Over, Sl — Slip, PSSO — Pass slipped stitch over) 


SIMPLE CROCHET PATTERN 

(UK CROCHET TERMINOLOGY) 
Ch 15 
R1 — [2 Tr, 1 Ch, 2 Tr] in 5th Ch from hook, *skip 
3 Ch, [2 Tr,1 Ch, 2 Tr] in next Ch, repeat from * to 
last 2 Ch, skip 1 Ch, 1 Tr in last Ch, turn 


R2 -3 Ch, skip first 3 Tr *[2 Tr, 1 Ch, 2 Tr] in 1 Ch 
sp, skip next 4 Tr, repeat from *, end by skipping 
last 2 Tr, 1 Trin next Ch, turn 
Repeat R2 until desired length 
(Abbreviations: Ch — Chain, Tr — Treble, Ch sp — Chain 
space, R- Row) 


These are forms of code, knitting and crochet code: 
sets of instructions used to complete several 
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Figure 1 

The knitted swatch 
illustrates a simple 
lace design achieved 
by following the 
dictated code and 
various commands 
therein. In knitting, 
stitches stay on the 
needle and are active 
for a whole row, and 
you use either single 
point, double point, or 
fixed circular needles 


Figure 2 

The crocheted swatch 
-a different effect 

is achieved from 
following the crochet 
code. In crochet, you 
complete each stitch 
one at a time, so only 
one stitch is live, and 
work with just a 
single hook 
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Above 

We downloaded 

the free (open- 
source) pattern 
(code) from the 
designer (developer), 
channelled the Force 
through our hook and 
yarn, and hey presto... 
The Child! 
(hsmag.cc/BabyYoda) 


Take BUILD HACK CREATE 


HackSpace 


HackSpace 


This tutorial is from 
HackSpace magazine. 
Each issue includes a 
huge variety of maker 
projects inside and 
outside of the sphere 
of Raspberry Pi, and 
also has amazing 
tutorials. Find out 
more at hsmag.cc. 
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rows of knitting or crochet. Note particularly, in 
both patterns, the use of brackets and asterisks, 
which are also of course used in coding — here, 
these are indicating a group of stitches that will be 
repeated, or a specific instruction to be carried out 
in a certain stitch such as, in the crochet example, 
completing two trebles, one chain, and two trebles 
in a single stitch. Designing a pattern is basically 
just like writing a program. You can think of the 
knitter or crocheter as the computer, translating the 
code, executing functions in the code line by line, 

in the correct order. Knitters and crocheters won't 
generally refer to these instructions as code; in fact, 
it may not occur to many of them that it is code, 

but any knitted or crocheted item, such as a scarf, 

is created one stitch at a time from such a piece of 
code. OK, if you're not a knitter or crocheter, these 
patterns won't make a huge amount of sense, and 
the purpose of this article is not to teach you how to 
knit or crochet. Also, knitting and crochet use very 
different techniques and tools to reach their end- 
products, but you can see from the patterns on the 
previous page that code plays a very important part 
in these two crafts — makers need the correct, error- 
free code in order to perform the function. 
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CRAFTY CORRELATIONS 

So, looking specifically at the handcrafts of knitting 
and crochet, it can be suggested that the numerous 
comparisons between coding and these two fibre- 
based techniques include the following: 


Standard notation 
Knitting and crochet patterns are written using a 
standard notation describing precisely the actions 
required to achieve the desired outcome — a series 
of detailed steps to create an object or a piece 
of fabric made from stitches. Similarly, computer 
programs are also written using a standard notation 
describing the steps a computer needs to take to 
solve a problem. 


Loop-the-loop 
As already mentioned, if you take a look at the 
patterns on the previous page, you will see the use 
of asterisks and brackets. In knitting or crochet, these 
basically indicate the beginning of a stitch sequence 
which often needs to be repeated until you reach a 


certain point, such as the end of the row, for example. 
Sounds familiar... a little like a loop in coding perhaps? 


3. Terminology 

Both the spheres of coding and fibre arts use their 
own languages or vernacular — a unique syntax that 
seems to make little sense unless you understand/ 
research the terms involved. A few baffling knitting 
expressions include rib, cables, brioche, intarsia, 
frogging, and entrelac, while crochet lingo includes 
seemingly unfathomable terms such as amigurumi, 
back post double crochet, filet, mosaic... and so 
on. But, as with anything, once you understand that 
jargon, it all falls into place. 


4. Open source 

In the world of the fibre arts, patterns are sometimes 
paid for, but can often be found for free. Fibre artists, 
like coders, are a generous bunch, and many people 
make their patterns available to all on sites such as 
Ravelry (see separate box). Hundreds of knitting and 
crocheting podcasters are also willing to share their 
knowledge for free on YouTube in videos showing 


»” 


Note particularly, in both 
patterns, the use of brackets 
and asterisks, which are also 

of course used in coding WwW 


how to crochet a Baby Yoda, how to weave a wall- 
hanging, or how to knit a pair of socks. There is a 
real sense of community in the fibre arts world, as 
the many forums and online communities will attest 
— much like the world of programming and coding. 


5. Maths, maths, and more maths 

When this author is knitting and crocheting, at the 
same time, she is also counting. It's about order, 
accuracy, and precision. Following the code, she 

is processing that algorithm that a designer has 
created in order to instruct her on how to achieve 
the end goal. When executing the code, she needs 
to count (a lot!). Stitch counts are critical, so she 
needs to follow the designer's code precisely, or 
that crocheted version of Bernie Sanders at the 
inauguration will have the wrong-sized head, (yes, a 
talented individual had the ingenuity to design such a 
pattern — hsmag.cc/Bernie). ‘Ssshh, l'm counting’ is 
a line that this author's family are more than familiar 
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RAVELRY: A CODING AND 
KNITTING COLLABORATION 


There are many stereotypes associated with knitting and crochet but, these days, the 
average age of a fan of these two crafts, in particular, is much lower than in years gone by. 
Banish (please!) any thoughts of little old ladies in rocking chairs — fibre artists are cool, 
on-trend, tech-savvy, and want to regularly communicate with fellow creators online. 

Consequently, tools have developed to meet the inherent demand for a form of ‘social 
networking’ specifically for the yarn arts. Ravelry (ravelry.com) was created in 2007 
by Jessica and Cassidy Forbes from Boston, Massachusetts, and now has over nine 
million (yes, you read that figure correctly!) users worldwide. Interestingly, one half of 
the founding partnership was originally a knitter, and the other was... a coder! Their 
complementary skills are still used today to keep this gargantuan network functioning at its 
optimum. Nearly half a million knit and crochet patterns, for example, can be downloaded 
from the site, some free, some paid for, thus generating an income for thousands of pattern 
designers and sustaining Ravelry so that it can continue to unite fibre artists. 

Users can utilise the organisational tools, share patterns, stashes, thoughts, ideas, 
discussions, and projects. It's a fibre-loving community using a massive database of 
patterns and yarns — you can filter your searches on hundreds of criteria and get instant 
access to exactly what you're looking for. It's free to join, and a great place to visit if 
you've lost your crochet or knitting mojo, as you're guaranteed to want to start at least 150 
different projects once you start looking for inspiration. 


with. Believe it or not, repetitive counting is also very 


calming as it’s so meditative. Above % 
$ A vast database of 
This author recently downloaded a free crochet thousands of patterns 
pattern in which the maths didn't add up, based on at your fingertips, 
j i or should that be 
what the code was telling her to do and the required needle tips? 


stitch counts at the end of each row. The pattern 
appeared to not have been tech-edited, so she 
emailed the company concerned and rewrote the 
bothersome incorrect elements of the pattern. She's 
determined to write more of her own crochet code 
now, as it’s really not that hard! 


6. Refactoring and checking for ‘bugs’ 

Just as coders will refactor code to try and improve 
the design of a piece of software, fibre artists do 
the same thing, as it's all in the finish. Most paid- 
for patterns, and many free patterns too, will be > 
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LEARN A NEW SKILL 


AND FURTHER READING 


If you would like to experience the many therapeutic benefits that knitting, crochet, 
weaving, or any other fibrous form of creativity can offer (mindfulness, reduction of anxiety 
and stress, improved cognitive function, sense of control, sense of achievement... to name 
just a few), then there are many options: 


e YouTube videos — there are hundreds to choose from, and it's how this 

author taught herself to crochet. Try: youtube.com/c/BlossomCrochet/videos, 
youtube.com/c/RJKnits/videos, or youtube.com/c/SpruceandLinen/videos 

e Aska friend/family member to teach you — nothing beats a hands-on lesson with 


an expert 


e Join an online lesson. Try: creativebug.com, skillshare.com, or udemy.com 
+ Buy a beginner kit- these come with instructions and everything you need. Try: 
weareknitters.co.uk, or bytomdaley.com/collections 
e Get yourself a book from the library — we suggest you grab a ‘How to’-type publication 
along with a stitch dictionary, if you are learning crochet or knitting 

When you get that ‘light bulb’ moment, and everything finally clicks into place, you'll feel 
such a sense of achievement and you'll be away (oh, and start making space for some yarn, 
fibre, tools... it's a rabbit hole). You might even start designing your own patterns...also 


known as coding! 


Shell 
Casting on 


Front: 
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Binding off 


Figure 3 @ 

The Python program 
prints out a chart 

of stitches for front 
and rear 


rigorously tested by test knitters or crocheters, and 
by tech editors, to make sure that there are no errors 
in the pattern. Much like coders and developers, 
designers will search for bugs in the system — 

the end goal in a knit/crochet piece of coding is 
documentation that delivers what it promises, and 
only once it has been debugged can it be released, 
or deployed in software terminology. As in coding, 
pattern designers will use trial and error to achieve 
their desired outcome. Designers will rewrite their 
code so that they explain the pattern, in as few 
lines as possible, very similar to the DRY (Don't 
Repeat Yourself) principle of software development. 
Fibre arts patterns and coding are both trying to 
communicate complex instructions as simply 

as possible. 


7. Creativity is inherent 

Fibre artists are, by definition, creative. They often 
tweak patterns, add their own touches, choose 
appropriate yarn colours, and basically express 
themselves through their yarny creations. Take, for 
example, yarn bombing (hsmag.cc/YarnBombing) 

— a creative, edgy, expressive form of street art, 
spreading colourful fibre joy. This author has recently 
found a pattern for crocheting toppers for UK 
postboxes, and hopes to create one soon for her local 
postbox. And, yes, coders are also creative — they 
need to possess a technical creativity in order to 
write any piece of software. It can be suggested that 
coders are aiming for a form of beauty in their code, 
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bug- and error-free, just as fibre artists want to see a 
beautiful end-product too. 


8. Tech skills are also essential 

It's a given that coders require technical expertise, 
but fibre artists have those skills too. Being able 

to read a pattern and translate it is a technical skill, 
as is knowing how to knit or crochet in the first 
place, knowing what yarns to use for each pattern, 
measuring gauge correctly so that the new jumper 
you are constructing fits you properly, or modifying 
patterns to include your own personal slant, for 
example. (See ‘Graphghans’ box.) 


F7 


You can do both - you can 
code and program and you 
can knit or crochet or = 


" 


spin or weave 


9. Continuous learning curve 

As in all areas of life, both coders and fibre artists 
are constantly facing challenges to develop, to learn 
more, and to hone their skills, as there are always 
new elements to master. Fibre artists will be learning 
new stitches, techniques, about new yarns, how to 
read charts, how to fix errors, while coders need to 
keep up with new languages, frameworks, libraries, 
and so on. 

Perhaps a key point to make here is that you can 
do both — you can code and program and you can knit 
or crochet or spin or weave. You can be both creative 
and technical at the same time. Coding and the fibre 
arts are not mutually exclusive pastimes — would 
you be surprised to find a coder or developer who 
likes to knit, or a professional crochet designer who 
also coded for fun? Based on the many similarities 
discussed here, we wouldn't be surprised at all... and 
there are indeed many people who happily do both. 


AN EXPERIMENT 
So, just to see what would happen, this author 
decided to take a very basic knitting pattern and 
turn it into Python code (with the help of her code- 
loving husband!) 

The original pattern she drafted was as follows: 
e CO 20 stitches 
e R1 &R2-K 
e R3-K 
e R4- K3, P14, K3 


TUTORIAL | Magri HE 


HOME ABOUTUS NEWS OUR PROJECTS 


EVENTS BLOG 


PARTNER/DOMATE NOW 


Left 9 

Africa Teen 

Geeks’ Knit2Code 
programme brings 
together girls of 
different generations 
to learn, relearn, or 
minine skills and handicrafts ca! cho affinity fc M. Knitacoc ap net es young g haut access te | enjoy knitting and, 
ugh knitting, as a by-product, the 
basics of computing 


What is Knit2Code? 


e Repeat R3 & R4 until work measures 10cm 
in length 

e Final 2 rows — K 

e Bind off 


You can find the link to the resulting Python code 
here (hsmag.cc/issue57). As you can see, there's 
quite a lot of repetition/looping here, along with a 
conditional (‘until work measures 10 cm in length’). 

In our Python code, we created functions for knit 
and purl, which simply add a letter 'k' or ‘p’ to a ‘row’ 
string the number of times specified in a ‘stitches’ 
parameter. We also created a special ‘row4’ function 
which calls the knit and purl functions to execute ¡ts 
mixture of knitted and purled stitches. 

An ‘addrow’ function adds each completed row to 
a ‘front’ or ‘rear’ string — since in knitting, the side of 
the work is reversed with each row, we alternate this. 

The first ‘for’ loop knits two rows (akin to ‘R1 8 R2 
— K' in the pattern). A ‘while’ loop then repeats rows 
3 (knit 20) and 4 until the ‘length’ variable (increased 
with each row) is 10 or greater. We finish with 
another ‘for’ loop to knit two more rows. At the end, 
we print the ‘front’ and ‘rear’ strings, which results 
in a chart of stitches for the front and rear of the 
work (Figure 3). 

To conclude, if you'd like to read more, we really 
suggest that you take a look at this article from The 
New York Times (hsmag.cc/YarnProgrammable) 
where the ideas of physicist Dr Elisabetta 
Matsumoto, that ‘yarn is a programmable material’ 
and that ‘knitting is coding’, are explored. It's mind- 
blowing stuff, looking specifically at the mathematics 
of knitting. Here, we have really only just skimmed 
the surface of the coding and fibre arts entanglement, 
but hope we have piqued your interest in this 
fascinating area. O 


COVERT CODE 


Did you know that you can encode secret messages into that hat or cardigan that you're 
knitting? Well, this is something that was used to great effect during wartime — yes, 
unassuming knitters became useful spies, using steganography (a way of hiding a message 
physically in plain sight) and passing on valuable information in their pattern of stitches 

to the people who could use the information effectively in the war effort. It was relatively 
straightforward to encipher information into a fabric using, for example, Morse code. When 
you think about it, it makes complete sense — knitting consists of two kinds of stitches, 

knit (flat stitches resembling a ‘v’) and purl (horizontal bumps) — and it is the chosen 
combination of these that makes a pattern, and is relatable to binary code. 

To illustrate, during World War I, Belgian Intelligence agents sought the help of knitting 
women who could see train stations and tracks from their windows. They asked them to 
monitor the passing of German Imperial trains — in their knitting, these inconspicuous- 
looking women would drop stitches or add extra purl stitches and so on, as a form of 
predetermined code, to signify how many artillery trains had passed, if a train full of troops 
had gone through, etc. They then passed their completed fabric to the Belgian Resistance, 
who could decode the fabric, based on their pre-agreed stitch meanings. Had they been 
discovered by the enemy, these knitters’ lives would, of course, have been in peril. It must 
have been a successful form of information gathering, as coded knitting played a part in 
WWII as well. This is a truly fascinating subject area if you are interested in history and 
knitting espionage, and you can read more here: hsmag.cc/KnittingSpies. 
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Who'd have thought 
that a humble ball 

of yarn and two 
wooden sticks could 
communicate vital 
intelligence? 
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Bulld . NA 
Mini Magic 
Mirror 


Shrink down a Raspberry Pi smart 
mirror to fit in smaller spaces 


he magic mirror is one of those great 

Raspberry Pi projects that looks cool, isn’t 

too hard to make, and is actually a bit 
practical too. The software is all basically taken 
care of, yet is very customisable for those who have 
the know-how to go further with their projects. 


Smart mirrors are too useful to just have them 
limited to one big mirror in your home, though, so 
we’ve collected some smaller versions you can try 
out to put above your sink, or even on your desk. 
Seeing is believing. 
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Magic Mirror basics 


How to build any kind of smart mirror with Raspberry Pi 


Build a frame 

Before anything else, you?1l need an 
old/spare TV or monitor for your magic mirror. 
You'll need to build a frame to the size of the 
display, so it’s no use starting without one. With 
the ability to take measurements, you can now 
get some wood from your local hardware store, or 
get a matching frame from IKEA or the internet 
to fit it in. You*ll also need some two-way mirror 
acrylic sheet or film to cover the display to make 
it truly reflective. 


Program 

The software for a lot of magic mirror 
projects uses the MagicMirror code from 
magicmirror.builders. It's easy to install and 
customise and, from a fresh Raspberry Pi OS 
install on Raspberry Pi or Raspberry Pi Zero, 
you can go to the Terminal to download the 
software with: 


git clone https://github.com/MichMich/ 
MagicMirror 


Head to the MagicMirror docs to see the full 
installation instructions and customisation 
options: magpi.cc/mirrorstart. 


Hang it up 

You’ll need to find a place with suitable 
access to power to hang up your mirror and make 
itwork. Use screws rather than picture pins 
wherever possible as the entire setup will be quite 
heavy, and it’s best for the project and anything 
near it to not fall off the wall. 

You can customise it with extra modules 

for different functions, connect it to your 
calendar, and much more for the true future 
living experience. 
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Mini Mirror Projects 


Make your smart mirror smaller 


SparkFun | magpi.cc/smallmirror 


This version of the magic mirror uses a smaller 
computer monitor and a deep shadow box frame 
to create a landscape-orientated mirror that can 
easily fit on a desk or side table. It was inspired 
by the busy personal life of the maker, and how 
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they and their partner could use some kind of 
‘battle station’ to keep track of their plans. 

The shadow box it uses is not quite the same 
size as the monitor though, and so, some space 
has been filled in with wood so that it looks a 
little more natural. This is something you’ ll have 
to contend with on any magic mirror project that 
uses premade frames but, with reflective film 
added on, it's a lot less noticeable than it would 
be otherwise. 

Finally, this tutorial has some great tips on 
customising your mirror’s layout and modules, 
tailoring them to your personal requirements. 


d The wood at the bottom helps fill in the space and 
raise the monitor up, and right-angle connectors 
help keep the whole system flat to the wall 


Smart Mirror using a Raspberry Pi Zero 


MAKER: Brad Morton for LinuxScrew | magpi.cc/smallmirrorzero 


While you can definitely make something 

small with a standard Raspberry Pi, using a 
Raspberry Pi Zero really allows you to bring 

the size of a smart mirror down. This one, also 
landscape in orientation, uses a very small 5-inch 
screen, all dropped into a frame from IKEA. The 
display is mounted to the back of a thin piece 

of mirrored acrylic that fills up the entire space 
within the frame. 
While you can basically hook up a Raspberry Pi 
Zero and stop there, this project shows you how to 
add a button that will sleep and wake the screen 

- saving on power and also letting you use the 
magic mirror as a full mirror. It requires a little 
extra hacking and the addition of a Python script, 
but it’s not all that difficult to do. 


Info screen projects 


Want the data but not the mirror? Here are some alternatives 


Digital Information Screen 


Using software called Yodeck, 
maker Syed Khairi was able to 
create a useful info screen for 
his science department. 


magpi.cc/discreen 


MagicMirror Alarm Clock : p À Chromium Kiosk 

While not really a mirror, = | NS “~ Kiosk mode in Chromium allows 
this alarm clock does use the : $ ul : you to create a selection of panels 
MagicMirror software to make =A ES T and functions that limit the user 
a very informative alarm clock SS = to certain functions — such as 
with easy customisation. mo EEN looking at their calendar. 


magpi.cc/magicalarm ie E magpi.cc/chormiumkiosk 


Unfortunately, the 
main MagicMirror 
software does not 
currently work with 
Pico - it's quite 


different from 
Raspberry Pi, so 

that makes sense. 
However, you can get 
Pico to display info 
on a screen with the 
right code - all you 
need to do is then 
add two-way mirror 
film or acrylic and 
you'll have a Pico- 
powered smart mirror. 


Google Home-enabled Smart Mirror 


MAKER: Zach | magpi.cc/voicemirror 


Adding voice commands to a magic mirror is to make it removable for easy maintenance. 
very cool, especially when it uses tech that There”s no soldering either - everything 

was once given away by The MagPi! The AIY just snaps in. 

Voice Kit is an easy way to add Google Home-like The trickiest part is getting the AIY Voice 
voice control to a Raspberry Pi project, and we Kit to work with the software, but Zach has a 
quite like this one that also repurposes an older great troubleshooting guide for you if you start 


pi-topCEED. It allows you to efficiently use space, having issues. 
as it’s already designed to be quite slim yet still 
hold a Raspberry Pi inside. 

It can also be done in an afternoon! Zach 
reckons it took him about two hours, and we can 
see why - all he needed to do was add the Voice 
Kit, the MagicMirror software, and the two-way 
mirror — which is cleverly attached with magnets 
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Mini Magic Mirror 
MAKER: GeekToolkit | magpi.cc/minimirror 


This magic mirror project truly is mini - it uses 
a3.5 screen, and a 115mm square two-way 
mirror. Don’t worry about the mixing of inches 
and metric, especially when this whole project 
will cost you from $60/£50 to make! 

The pyramid-style stand for the screen is great 
for multiple reasons. Firstly, it’s very stable; 
while the whole setup isn’t very heavy, it still 
needs to be sturdy. Secondly, it is hollow, allowing 


for more than enough room for a Raspberry Pi space for you to plug the mirror into the mains — 
Zero to sit inside. or to a mobile battery if you want to take it around 

The stand is made up of two 3D-printed parts your home. It’s a very cool, very low-effort project 
that neatly connect together, and also allows that has many uses. 
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Infinity mirror 


Not very smart but 
very cool, infinity 
mirrors use mirrors 
and lights to make it 


A Lg RO TA look like they go on 
; £ ; í > aA forever. Toby Roberts, 
ai f i > > ESA 33 from Raspberry Pi, 
= = built this and others 


with a Raspberry 
Pi Pico inside 
and powering all 
the lights. 
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Get started with your new 


Introducing the all-new 
Raspberry Pi computer 


Zero 2 W & Pico W products 
Learn basic electronics and Incredible projects built by 
coding skills Raspberry Pi’s community 


Buy online: magpi.cc/store 
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uity 2040 


> Pimoroni >» magpi.cc/tufty2040 » From £24 / $24 


With a colour LCD screen, is this the ultimate A. Therear features the 


battery connector, edge 
connector, and power and 


interactive name badge? By Phil King boot /USR buttons 
he Tufty 2040 badge is based on although the Tufty has no circuitry to charge it. 
T Raspberry Pi’s RP2040 microcontroller Naturally, power drain is higher than using an 
chip, as used on Pico. It goes one better e-ink display: around 100 mA in total. The on- 

DISPLAY: than the Badger 2040 (reviewed in issue 116, board light sensor could be used to auto-dim the 

rep display Ips magpi.cc/116) with the use of a 2.4-inch display via PWM, however. 

320x240 pixels colour LCD screen in place of a monochrome A neat bonus feature is the Qwiic/ STEMMA QT 
e-ink display. port which can be used to connect 12C sensors 

a With a rapid refresh rate, the LCD enables and other add-ons. So you could even use the 

connector z the Tufty to do a lot more, including showing Tufty 2040 as a data display instead of a badge. Hl 

(input range animated text and graphics. A simple game 

3-5.5V), USB-C is even included as one of the preloaded 

FEATURES: examples, selectable via a menu when you 44 | With ad rapid refresh rate, 

5 x user turn it on. Others include wavy scrolling text, 

buttons, LED, Pride and retro badge layouts, and an old- the LCD enables the Tufty 

Qwiic/STEMMA school ‘Sketchy-Sketch’ drawing tool. As on 

QT port, the Badger, control is via five programmable to do a lot more Ø 

preakout eage user buttons. 

connector (12C, a 

UART, SWD), Connecting the Tufty 

8MB flash 2040 to a computer 

storage via USB enables you 


to program it in 
MicroPython or C++. 
The PicoGraphics library 
makes it relatively 

easy to write text and 
draw shapes. JPEGs can 
also be rendered, and 
sprites imported froma 


Ve rdict sprite sheet. 


The crisp colour Wear it well 
Screen makes For portable use, a JST-PH 
for a super-cool 

battery connector accepts 


interactive name k 
badge that is input from 3V to 5.5V. An 


versatile and fairly optional Accessory Kit 
easy to program. includes a 3xAAA battery 
pack, Velcro pad to fix it 
to the rear, and lanyard. A $ ! - ) 
/10 less bulky alternative is to | N ¢ > s : A The Tufty 2040 displaying the Pride 
use a LiPo battery, à HON ` Ñ 5 ` badge example on its colour LCD 
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Automation 20 


> Pimoroni b magpi.cc/auto2040w » £59 / $58 


POWER: i i ic j 
See With a Pico W aboard, this is a home 
oV via screw i 1 j 
mirar automation powerhouse. By Phil King 
INPUTS/ nlike other home automation boards 
OUTPUTS: U we’ve seen, the Automation 2040 W is 
AL a standalone affair with a pre-soldered 
12-bit analogue Pico W aboard. So, all you need to supply is the 
inputs, 3 x power: from 6V to 40V, via two screw terminals. 
sourcing Functionality-wise, it’s similar to Pimoroni’s 
Sea Automation HAT, although that could only handle 
ae up to 24V. Tolerant up to 40V, the Automation 
FEATURES: 2040 W is compatible with 12V, 24V, and 36V A Woucanploaiamthesa boat Pie Wk 
2 user 


buttons, reset 
button, status 


systems for all your home automation needs. 
At the bottom of the board, three relays (all 
with the option of a normally closed or open 


MicroPython or C/C++ using Pimoroni's libraries 


Let there be light 


LEDs, 2 x 

Qwiic/STEMMA connection) can output up to 40V at 1A, or 24V at One really nice touch is the inclusion of a status 

QT ports, 2A. Next to them are three (switchable) sourcing LED (wired directly) for every input and output, so 

AS. outputs that can provide up to4Aatupto4oVfor you can see when it's active — ideal for debugging 
eader 


P The Automation 


2040 W has a wide 


range of 40V tolerant 


inputs and outputs 


things like larger motors, solenoids, and pumps. 
Along the top are three 12-bit analogue inputs 
and four buffered digital inputs, all tolerant up to 
40V. There’s also a pair of 5 V outputs for lower- 
voltage components. Finally, there’s a couple of 
Qwiic/STEMMA QT ports for breakout sensors, and 
an unpopulated header for a few of Pico W’s pins. 


[oar i) meres | 
Enc Ga ad 
; - Automation 20401 
Be ioes | 
| 


m One really nice touch is 
the inclusion of a status 
LED for every input 
and output Ø 


programs (in MicroPython or C/C++), even when 
external hardware isn't yet connected. We also 
like the two programmable 
push-buttons with white 
space next to them to 
write labels. 


Verdict 


Best of all is Pico W’s 
own wireless connectivity, 
which means that you 
can easily set up a web 
interface (an example 
is included in Pimoroni’s 
Getting Started Guide: 
magpi.cc/auto2040wguide) 
to control and monitor 
your devices. M 


A little expensive, 
but then itis a 
standalone device 
and will work with 
almost all home 
automation systems. 


8 10 
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10 Amazing: 
Cases 


Keep your Raspberry Pi, or Raspberry Pi 
Pico, safe with these great enclosures 


essentially naked. However, you can easily get a case 

for your Raspberry Pi and give it some extra protection 
from the elements and spilled drinks. Here are ten of our 
favourites, including some nice cases for your Pico. M 


Yy ou may have noticed that a Raspberry Pi is sold 


a SmartiPi Touch Pro 


Case and stand 


This enclosure allows you to create an entire Raspberry Pi system and 
put it anywhere around your house. 


magpi.cc/smartipi | £30 / $25 
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a Official Raspberry Pi 4 Case 


Simple and clean 


This sleek and simple case is the official case for Raspberry Pi, 
acting as a perfect enclosure at a low price. 


magpi.cc/pi4case | £5/S5 


> Gameboy NANO 


Adorably tiny 


One of the smallest cases we've seen 
for Raspberry Pi Zero, it also turns it 
into a handheld console. Great for 
small fingers. 


magpi.cc/gameboynano | Free 


> Zebra Pico Case 


Layered protection 


Zebra makes lovely cases for 
microcomputers and dice, and this 
layered case for Pico offers great 
protection with full coverage for all the 
delicate parts, along with full access 
to GPIO and power. 


magpi.cc/zebrapico | £8 / $9 


Sl 


a Raspberry Pi Pico Case 


Officially inspired 


While not an official case, this 3D-printed case is created ina 
similar style to the official ones, with a base and a lid. 


magpi.cc/3dpicocase | Free 


a Official Raspberry Pi Zero Case 


Simple and tiny 


A companion case to the official case, this time shrunk down to fit all types of 
Raspberry Pi Zero. 


magpi.cc/pizerocase | £5 / $5 


> Acrylic case for 
Raspberry Pi Pico 


Two acrylic slabs 


Avery simple case made of 
two acrylic pieces that you 
join together through Pico's 
mount holes. 


magpi.cc/acrylic | £8 / $10 


a FLIRC Raspberry Pi Case 


RESOURCES | Magri MEM 


4 NESPi 4 Case 


Retro console camo 


This great classic console replica also allows you to use the 
front ports as you normally would, and add fake cartridges. 


magpi.cc/nespi4 | £28 / $27 


a Pico USB Rubber Ducky Case 


For media PCs 


This beautiful-looking case is made with aluminium, and acts as a heatsink. 
The design lets it sit neatly under a TV to power your media centre desires. 
There's also a Zero variant. 


magpi.cc/flirc | £14 / $16 


Converting enclosure 


This 3D-printable case includes a nice little groove to put in a 
specific micro-USB to USB-A adapter, allowing you to easily 
plug a Pico into your computer of choice. 


magpi.cc/duckycase | Free 
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Learn computer science 
with Raspberry Pl 


Go" la Ts a Cors a = 
Resources to help you get to grips with Computing 
computer science on Raspberry Pi. By Phil King PP... 


Jaco ow range of hee computing courses yew 


Raspberry P1 
Computer Courses 


Raspberry Pi There has never been a more confidence while learning how there’s also an array of computer 

Foundation important time to learn the to solve problems and express courses. The ‘Computer Systems 
fundamentals of computing, themselves creatively. and Networking’ category is 

Price: whether you have a related To that end, the registered a good place to start; among 

hies career in mind or you just want charity has created a large range courses aimed at teachers, you 

magpi.cc/rpfcourses to feel more confident in how of learning resources aimed at can check out ‘Understanding 
you deal with information various abilities and audiences. Computer Systems’ and ‘How 
technology. The Raspberry Pi While the Raspberry Pi Projects Computers Work: Demystifying 
Foundation was created with the site (magpi.cc/projects) Computation’. Click on 
aim of enabling every young (or offers numerous tutorials for any course to enrol for free 
older) person to develop that computing and digital making, on FutureLearn. M 


Free courses 


Learn computing with these CS50: INTRODUCTION TO to the subject and gets you writing 
; COMPUTER SCIENCE and debugging Python programs. It 
fre e on | INE courses Harvard University's excellent includes video Lectures, slides, and 
entry-level course teaches you how other resources. 
to think algorithmically to solve > magpi.cc/mitintrocs 
ta Typ nd Var problems. It covers a wide range 
. int of key topics and features a cloud- PROGRAMMING 101 
e NPE ian a based IDE for coding tasks. Comprising a series of video 
tears te range of vakars they can store pecera > > magpi.cc/cs50 lectures, this Udemy course 


nited to 32 bits worth of inform; 


will provide you with a broad 
INTRODUCTION TO COMPUTER foundational knowledge of 
SCIENCE AND PROGRAMMING hardware, networking, programming, 
While fairly old, this course from MIT and licensing. 
gives beginners a good introduction >» magpi.cc/udemy101 


integer Range 
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mn TO CODE 


AR 
ar SOLVING 


PROBLEMS 


Learn to Code by 
Solving Problems 


Daniel One of the fundamental aspects 

Zingaro of computer science is learning 
how to code. For this, Python 

Pace is one of the most popular 

£30 / $35 


and easy-to-learn languages, 
since it’s well-structured 
and is used in all sorts of 
real-world applications. 

Daniel Zingaro’s programming 
primer is a suitable introduction 
for beginners, covering core 
concepts such as loops, 
lists, sets, functions, file 
management, sets, dictionaries, 
and algorithms. It concludes 
with a chapter on how to write 
more efficient code. 


magpi.cc/ 
zingaropython 


a prrecn precaanning PRIMER 


In addition, and perhaps 
more importantly, it teaches 
you the type of thinking 
required to solve problems 
using a computer. The key is to 
use top-down design to break 
a larger problem down into 
smaller tasks that can be tackled 
using functions. You can test 
your problem-solving skills ona 
series of exercises at the end of 
the book. M 


The Official Raspberry Pl 


Beginner's Guide 


a A Raspberry Pi computer 
represents an inexpensive and 
Price: easy way to get into computing 
£10 / $12 (Free PDF) and digital making. This official 
magpi.cc/bguide4 guide book (also available 


as a free PDF, and in several 


RASPBERRY P1 400 


THE OFFICIAL | 
Raspberry Pi 


Beginner's Guide 


languages) starts off by detailing 
how to set up your Raspberry 

Pi hardware and navigate its 
desktop operating system. 

It then embarks on an easy- 
to-follow introduction to the 
fundamentals of programming 
- in chapters for both the block- 
based Scratch 3 and text-based 
Python languages - involving 
the creation of a variety of 
software projects and games. 
Not only that, but it then 
moves on to cover ‘physical 
computing’, controlling 
electronic circuits connected to 
Raspberry Pi’s GPIO pins, viaa 
number of fun projects. In short, 
you’ ll discover how computers 
work, learn to code, and start 
building some amazing things. El 
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Recommended 
reading for learning 
computer science 


CODE: THE HIDDEN 
LANGUAGE OF COMPUTER 
HARDWARE AND 
SOFTWARE 

Recently updated to an 
expanded 2nd Edition, Charles 


Petzold's book explores 

in detail how a computer 
works, gate by gate. There's 
a companion website at 
codehiddenlanguage.com. 
» magpi.cc/codehidden 


GROKKING ALGORITHMS 
Algorithms are the building 
blocks of all computer 
programs. This book shows 
you how to apply common 
algorithms to the sorts of 
practical problems you may 
face as a programmer. 

> magpi.cc/grokalgo 


PYTHON CRASH COURSE 
One of the easiest-to-follow 
programming books for 
beginners, it's project-based, 
so you'll be creating Python 
programs as you learn key 
skills that are applicable to 
most other languages. 

> magpi.cc/pythoncrash 


WE Mägi | INTERVIEW 


centre for 
computing 


history _ 


V The history of portable 
computers makes it seem 
wild that laptops exist at all 


The Centre for 
Computing History 
Interview 


We talk about the incredible museum located in Cambridge, full of classic 
computers, retro games, and a giant processor 


> URL computinghistory.org.uk 


ambridge has many 
C attractions for tourists. 
It’s a very old city with 
a rich history and heritage, 
especially when it comes to 
computers — a lot were designed 
there, including Raspberry Pi. 
A trip to the Grand Arcade’s 
Raspberry Pi Store should be on 


— 


every tech fan's bucket list when 
in Cambridge, but you should 
also make sure to check out the 
Centre of Computing History. 
It's regularly ranked highly 
on Cambridge “off the beaten 
path? articles for visitors and for 
good reason, it’s a wonderland 
of electronics from the dawn of 


A PORTABLE — orion 


= 1380's === [19 
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computing to now, showing the 
evolution and ever-changing 
shape of PCs, mainframes, 
mobile phones, games consoles, 
and more. 

“So it goes back to [August 
2013],” Jason Fitzpatrick, the 
CEO and Curator, tells us. “It 
was originally my collection. My 
interest. My collection that was 
going a bit haywire. 

“Business was good at 
the time, and I spent a bit of 
money on machines. It’s the 
standard story any collector will 
recognise; you buy the machine 
that you had as a kid. Then you 
buy the machines you wanted as 
a kid, then machines that your 
friends had that you couldn’t 
have, and then you find any 
reason to expand. 

“I had machines like the BBC 
Micro and the Spectrum, up on 
shelves in the office at work. 
And it didn’t matter who came 
in, you'd end up wasting the first 
20 minutes on ‘Oh, I had one of 
them.’ It was just was obvious 
that, whilst I had a passion for it, 
everybody has something to say 
about it. 


MägPi 


Just about every major 
console is represented in 
the museum 


processor, an incredible 


We built the website for it and, at recreation ofa CPU from Sete 


using segmented displays that 
can be used to teach how a 
processor works. There’s a 


that point, people started donating 


classroom area with BBC Micros, 
“CA group of us] got together Building up Acorn computers, and 

and said, right, let’s try and The museum now is crammed Raspberry Pi 400s, and the main 
do something and create a with computers and displays exhibit is in a large warehouse 
museum. That museum was from many eras of many in the rear. 
about half an hour away from different kinds. An entrance It wasn’t always that way 
Cambridge. We moved my area and canteen includes some though - when it opened, 
company to a place where I arcade machines, some small computers were set out on 
could give it the ground floor. displays that are changed out tables with white cloths and 
And the museum physically regularly, and the mega- not everything was painted yet. 


existed on this ground floor, but 
it was really small. We built the 
website for it and, at that point, 
people started donating. There 
were three small rooms and they 
all just got filled up within... it 
felt like weeks, but it was within 
a year. You couldn't move for 
donations and there was no 
display space left. So we closed 
again and it went in limbo a 
little bit for some time.” 

Due to a fortunate Twitter 
encounter, the team were able 
to be introduced to enthusiasts 
that allowed them to finda 
place in Cambridge, where the 
Centre for Computing History 
now lives. 


You can play Tetris on the megaprocessor 
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After the passing of Sir 
Clive Sinclair, a display in 
his honour was set up 


The main gallery is 
huge, and packed 
with amazing exhibits 


magpi.cc 


However, as the collection grew, 
it became too big for it all to be 
displayed. There are roughly 160 
pieces on display now, with over 
a thousand in storage. How do 
you pick what to display though? 


We change things around and you can 


Acorns and Raspberry Pi 400 go hand in hand 


“You’ve got to represent 
kind of the story of the time, 
although some things stay as 
the are,” he explains. “We’re 
really lucky as a computer 
museum, you can pitch your 
tent anywhere in terms of, if 
something happens in the news 
or whatever, you can usually do 
some sort of display around [it]. 
What haven’t computers been 


reflect popular culture and all sorts 


The Centre for Computing History 


involved with? Sadly, Sir Clive 
Sinclair passed away not long 
ago, so we have a little display 
of his stuff [in the entrance]. 
“So, we change things around 
and you can reflect popular 
culture and all sorts, so it’s a bit 
fluid. We change things around 
a lot to keep it interesting for 
us, but also for visitors, because 
we do get a lot of repeat visitors. 
So it’s nice when they can come 
back and see different things.” 


Communities and schools 
The museum also acts as a 
space for various computing 
and retro gaming communities 
to gather for an evening. 
Whether you’re an Acorn Head 
or a C64 Fan, there’s usually an 
event planned. 

It’s also often used by schools 
for a day trip during term time, 


There are manv machines on displav 


Menor cor 
TMa taari Tue COMPUTE 


A The evolution of transistors 


with groups learning computing 
appropriate to their level 
through various activities. 

“The feedback we get from 
schools is embarrassingly high,” 
he admits. “It looks faked. The 
exit poll is 98%, nearly 99% 
positive. It’s really cool. When 
the schools visit, they’re super- 
busy and they don’t get a great 
deal of time to just mess around. 
Chris Monk, learning advisor], 
who designed the workshop 
and the system for teaching 
allows us to] have 60 kids, 


so a lot to deal with. We split 
them into groups of 15; one lot 
in [the entrance area] working 
with the mega-processor on 
whatever level that suits. Then 
another lot in the classroom, 
doing whatever workshop they 
want — it might be electronics, 
and it might be programming, it 
might be TWINE, [it] can be BBC 
Micro. We still teach Basic on 
the BBC Micro because Basic and 
Python aren’t that dissimilar. 
We'll have a tour going on in the 
main gallery, then the fourth 


A Not included: episodes of Bagpuss 


group has got a bit of time 
to themselves.” 

While we visited, there were 
plenty of families around 
with their kids, checking out 
all the amazing displays and 
playing games from the 1970s 
and the 2000s, so it’s not all 
educational. There’s also several 
Raspberry Pi behind the scenes 
powering the fun. M 


INTERVIEW | MägPi MEE 


4 Seeing the miniaturising 


of tech into one pocket 
device really puts it into 
perspective 
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MagP1 
Monday 


Amazing projects direct from our Twitter! 


very Monday we ask the question: have you 
made something with a Raspberry Pi over 
the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 
they’ve made. 
Here’s a selection of some of the awesome 
things we got sent this month — and remember to 
follow along at the hashtag #MagPiMonday! Ml 


01. Kevin's dog Archie looks amazing in his 
special LED coat 


02. You can't see from this screen, but the 
spyalass is built into a Pringles can 


03. Glad to see the Talkative Tube 
dashboard project from issue 120 is 
being hung nicely on the wall now 


04. This higher tech, yet lower fidelity, 
version of Battleships looks very fun 


05. Becareful when gutting something 
like this - although the outcome is well 
worth it 


06. We bet, at a slow speed, this would 
quite a nice and calming lamp for sleep 


07. This is extremely pretty in motion! 


08. Love the idea of this - there's something 
very cool about analogue meters 


09. Anicely built looking camera! The 
Raspberry Pi High Quality camera can 
pull off some great shots 
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£ Kevin McAleer 


@TheMagPi Happy #MagPiMonday - this weekend I’ve 
been working on CyberDog which is an RGB LED cost 
for my dog Archie. It’s powered by a @Raspberry Pi 
Pico W and a @pimoroni Plasma 2040. Link to full 
video here: youtu.be/_FK4afSG5fA #maker 
#micropython #raspberrypi #picow 


Razvan T. Coloja 
@cypresstwist 


My project is almost finished. #\MagPiMonday 

A @Pimoroni 2.1” Round HyperPixel screen, a 
Waveshare Battery HAT and a Raspberry Pi Zero W. 
Plus about 200 short nature videos converted to 
square format and made to run from a playlist with VLC 
in live wallpaper mode. Spyglass fun. 


THIS MONTH IN RASPBERRY PI | MägPi MS 


Talkative 
Tube 
Dashboard 


Zwetsloot and everyone at the Magpi for the article. It 
still works. 


RaspberryPint 
Replying to @TheMagPi 
Finally hung my "Talkative Tube" project from MagPi bod Dr Footleg - Roboteer 
#120. It fits in well between my mum's painting and @drfoctieg 
mum in law's Japanese scroll. Big thanks to Rob 


Replying to @TheMagP 


| wrote a mini-battleships game on the Pico using the 
@pimoroni RGB Keypad. #MagPiMonday 


È Dr Footleg - Roboteer warfootieg - Aug 31 
| present ‘Pico mini battleships’ on the @pimoroni RGB keyped. Find the pirate 
ships hiding on the high seas! My first C++ masterpiece 


Show this thread 


Michael 
Smdsennett 


Replying to @TheMagP 


Raspberry Pi and Arduino combination to replace the 
internals of a 1972 Wurlitzer jukebox. 


Patrick 
@gunderson 


Replying to @TheMagPi 


For my atrium running on a PI Zero W 


Brian Starkey 
@usedbytes 


Replying to @TheMagPi 


| made good progress on the software for my Pico- 
powered LED matrix lamp #MagPiMonday 


Tom 


@tdsepsilon 
Replying to @TheMag?i 


Happy #MagPiMonday I’m working on a @Raspberry_Pi 
camera project that uses #leica M lenses and the piHQ 
camera module called the #piecacamera #pieca 


PIECA 5 


Gary Bleads 
@gOhjq 


Replying to ETheMagPi and DRaspberry_Pi 


Pve been using a pico w on Wi-Fi to display my PCs 
cpu load, temperature and memory usage 


r 
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Raspberry Pl 
at SiliCon! 


The cosplay and maker convention was a hubbub of cool costumes and cooler tech 


coming back, and that means you?! start 

seeing Raspberry Pi booths popping up at 
tech- and maker-related cons. The team already 
attended Embedded World earlier in the year and, 
this time, they were in attendance at SiliCon in San 
Jose, California. It’s a cosplay and maker con from 
Adam Savage of Mythbuster’s fame, and the team 
was there to show off just how good Raspberry Pi 
Pico could be for making and cosplaying. 

Features Ed Rob went along to help out and show 
off Pico, as well with the Poltergust G-00 that you 
can build on page 58. It was great to get back to 
these kind of big cons, with a bustling artists alley 
full of excellent pieces, weird and wonderful crafts 


A s restrictions are lifting, conventions are 


01. Alasdair Allan shows off how easy it is 
for sale from all corners of the makersphere, and o program LEDs on Pico, and also how 
just a lot of nerd stuff on display to appreciate. vourcanian BOOM anit 

We spoke to Matt Richardson in The MagPi 120 02. We saw a few excellent robots at 
(magpi.cc/120) about joining Raspberry Pi Ltd ea anit ini wondenul 
from the Foundation to work on events, and one of Ñ ; f 
the things he told us was about the excitement of ni IO pubs e ea 
people meeting someone from Raspberry Pi. earning the ropes with Pico 

“It’s funny when we're at an event and someone DA. Matt had sorted outa tunideme tor 
comes up to us, completely taken aback by the people to try out and learn about Pico 
fact that they’re seeing someone from Raspberry 05. Free swag and many Pico projects were 


Pi in-person,” Matt said. “Many people still 

think of us as a tiny group of people who make an 
affordable computer. They really don’t expect us to 
be out in the world sharing the ‘good word’ about 
Raspberry Pi.” 

There were plenty of folks coming up to chat 
about stuff they’d made, stuff they liked, and 
more. Hopefully Rob will get to see you at a future 
event with Raspberry Pi. Hl 
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on display for folks to look at 
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MéigPi 


The whole booth was quite simple, 
but showed off the strengths of Pico 


The Cosplay Grade RX-78-2 Gundam 
- complete with accurate decals 
from the model kit - was keeping the 
convention safe 


Features Ed Rob helps out someone 
with their Pico code 


A young Deadpool cosplayer 
is mysteriously drawn to the 
Spider-Man robot 
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INTRODUCING 


GPS-RTK HAT  ,, 


FOR RASPBERRY PIS 2⁄4 


CENTIMETER-LEVEL 
UBLOX GNSS MODULE 


GPS-RTK HAT 


“The Red Reactor is a high-performance battery power board “This ZED-FgP-based Raspberry Pi GNSS HAT provides centimetre- 
designed to meet high-level requirements, and has been tested level accuracy in seconds. It offers features such as: multi-band RTK 
cleanly delivering in excess of 4 amps to a wide range of designs with quick convergence times, a high update rate, support for moving 


with the Raspberry Pi 4, Model 3 (A+ and B+), and Pi Zero, along 
with ancillaries such as a display, USB hub for keyboard, mouse, 
and webcam, and even an audio amplifier.” 


base RTK mode, simultaneous reception of four GNSS systems, support 
for augment positioning systems, accurate and quick positioning with 
minimal drifting, and anti-spoofing and anti-jamming capabilities.” 


kck.st/3DqT9Kj kck.st/3RvM8fm 


Entaniya 
VR 220 Camera 


for Raspberry Pi Camera Module 2 


The modified camera enables the 
attachment of various M12/P0.5 lenses to 
Raspberry Pi Camera Module 2. 

Equipped with the 220-degree fisheye lens 
(RP-L220) preinstalled, the camera can be 
used as a circumferential fisheye camera 
with a viewing angle of 220 degrees. 


.entaniya.co.jp/en/ 
VR 220 Camera prebuilt version (RP-VC1) VR 220 DIY Modification Kit (RP-MK1), Various interchangeable M12/P0.5 lenses 
incl. Raspberry Pi Camera Module 2 Raspberry Pi Camera Module 2 is not included for the Entaniya VR 220 Camera 


@ 
"a 


O 


Q 


For inquiries, please contact products@entaniya.co.jp 
Entaniya Co.,Ltd., Nishiwaseda 2-5-13, Shinjuku-Ku, Tokyo 169-0051, Japan | www.entaniya.co.jp 


ME MiigPi | YOUR LETTERS 


Saving energy 


I have an idea for an article or an article series. Energy consumption 
should be at the lowest possible in climate crisis times, so maybe you 
could run programs on low-cost Raspberry Pi that help monitor and 
save energy. 


Jürgen via email 


That's a great idea. We are doing a feature on using Pico for smart 
appliances and home monitoring in an upcoming issue. We will be sure 
to include an energy-saving aspect to it. In the meantime, be sure to look 
at using Energenie products with Raspberry Pi to control and monitor 
electrical usage (magpi.cc/energenie). 


< Monitoring and 
saving energy 
is an important 


E 
@ ENERENG 
part of the 


y modern world 
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A Archie the CyberDog on a flashy walkabout 


Rainbow dog 


Happy #MagPiMonday (magpi.cc/magpimonday). 
I’ve been working on CyberDog, which is an RGB 
LED coat for my dog Archie. It’s powered by a 
Pimoroni Plasma 2040. There is a link to full video 
here: magpi.cc/cyberdog. 


Kevin vio Twitter 


That's an excellent build Kevin, and Archie looks 
amazing in that rainbow coat. We will be getting in 
touch and doing an interview with you on that build. 
Other readers, be sure to share your projects with us 
on Twitter using the hashtag #MagPiMonday. 


Contact us! 


> Twitter  (OTheMagPi 


> Facebook magpi.cc/facebook 


> Email 
> Online 


magpi@raspberrypi.com 
forums.raspberrypi.com 


I just wanted to let you know how much I enjoyed 
reading about Fireball Aotearoa [see The MagPi issue 121, 
magpi.cc/121 - Ed]. I’m an amateur astrophotographer, 
and it never occurred to me that you could use the 
power of Raspberry Pi with video cameras to capture 
and locate falling meteorites. Whatever will people 
think of next? Bravo to Scott, Taylor, and Rowe. 


Thomas vic email 


Yes. It is a fantastic use of Raspberry Pi, and we hear 

the team is expanding the project to capture even more 
falling meteors. We are glad you enjoyed it, and be sure 
to keep reading into the winter months as we have more 
night sky features then. 


This camera locks on to a fireball as 
it travels across the sky and reports 
the meteor landing location 
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This kit allows you to add 
an e-ink display to Pico for 
extremely pretty looking 
projects that dont need 

to update their info often. 
We reviewed it last issue 
and thought it was quite 
powerful, with a lot of great 


functions. Now is your 
chance to get one! 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/epdk 


Terms & Conditions 


Competition opens on 28 September 2022 and closes on 27 October 2022. Prize is offered to participants worldwide aged 13 or over, except employees of Raspberry Pi Ltd, the 
prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram, Facebook, Twitter or any other companies used to promote the service. 
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(How do 1 fix it?) 


BY BARRY COLLINS 


takes the most common 
computer problems and tells you 
how to fix them. It's as simple 
as that! If you've ever wondered 
why your laptop won't turn on, 
you can't get a WiFi connection, 
your printer isnt printing, or why 
everything is so slow — well, this 
is your book... 


a 


e 


THE MAGPI #123 


DON'T MISS OUT! 
magpi.cc/subscribe 


@TheMagPi 


fb.com/MagPiMagazine 


magpi@raspberrypi.com 


EDITORIAL 
Editor 

Lucy Hattersley 
lucy@raspberrypi.com 


Features Editor 

Rob Zwetsloot 
rob@raspberrypi.com 
Sub Editor 

Nicola King 


ADVERTISING 

Charlotte Milligan 
charlotte.milligan@raspberrypi.com 
+44 (0)7725 368887 


DESIGN 


criticalmedia.co.uk 


Head of Design 
Lee Allen 


Designers 
Olivia Mitchell, Ty Logan, 
Sam Ribbits, 


Illustrator 
Sam Alder 


CONTRIBUTORS 


David Crookes, PJ Evans, 
Rosemary Hattersley, Nicola 
King, Phil King, Simon Long, 
Sean McManus, KG Orphanides 


PUBLISHING 


Publishing Director 
Russell Barnes 
russell@raspberrypi.com 


Director of Communications 
Liz Upton 


CEO 
Eben Upton 


DISTRIBUTION 


Seymour Distribution Ltd 
2 East Poultry Ave, 
London EC1A 9PT 

+44 (0)207 429 4000 


SUBSCRIPTIONS 


Unit 6 The Enterprise Centre 
Kelvin Lane, Manor Royal, 
Crawley, West Sussex, RH10 9PE 
+44 (0)1293 312193 
magpi.cc/subscribe 
magpi@subscriptionhelpline.co.uk 


is printed on p r sourced 
forests and the printer 

vironmental r n 
ich has beer 


This ma 
from 


urice Wilk 
Innovation Park, C 


Building, 
ley Road, 
ublisher, 

>pt no 

f any omissions 


se noted, 
content in this ma eis ed under 
aCrea 
S NonCommercial- 
_ | 30 Unported 
Fasa | (CC BY-N 
ISSN: 2051-998 


ME Mägi | THE FINAL WORD 


Retro education 


How retro computers, not typist courses, made all the difference 


ur big theme in this edition 
O of The MagPi has been retro 

computing. I remember 
getting into computers when I was 
little. One day, a BBC Micro turned 
up at school and I was hooked. My 
dad took some persuading, but 
eventually I sweet-talked him into 
buying the family a ZX Spectrum 
48K. Neither of my two older 
sisters was interested, so I got it all 
to myself. 

I loved the way you could create, 
and see, things on the screen, 
how programs could be used to 
make things. While other people 
saw glorified calculators, I was 
entranced with interactive stories 
like The Hobbit and The NeverEnding 
Story. When I wasn’t reading 
fiction, I was lost in a world of 
pixellated narrative. 

When I wasn’t reading books or 
playing adventure games, I was 
learning BASIC and making my own 
creations. Computing classes 
covered everything from acid-etched 
circuits to PASCAL programming. 

As | worked my way through 
school, the computer became less 
about exploring the potential of a 
wonderful new gizmo and more 
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about fitting students into the mould 
of office life. By the time I went to 
college, I was being taught touch- 
typing and how to format word- 
processing documents. 

My love of narrative was filled with 
English and art, and computing 
became a personal hobby and less of 
an academic study. This is a shame 


m Cutting-edge 
technology can 
trace a path back 
to earlier days Ø 


because computers are incredible 
things. Packed with unlocked 
potential that can be used in all 
kinds of scientific and creative 
endeavours. Without computers, we 
wouldn’t have modern art in its 
current form; or video, film, or 
modern music. Still, I managed to 
bring it all together by editing a 
magazine about computers and 
taking courses at MITx. 

It’s no surprise to me that some of 
the most creative people I’ve ever 
met are quite nerdy; and vice versa. 


The secretarial training was the 
opposite of both: learning by rote 
with no understanding. It was bland. 
In retrospect, I should have taken 
the electronic typewriter apart to see 
what was going on inside. 

I like to think that Raspberry Pi 
and the new Pico microcontrollers 
can fill the tech void that is teaching, 
otherwise smart kids, basic office 
skills to tick government check 
boxes. Simply putting bare tech in 
front of kids who are interested can 
make all the difference. 

Our retro gaming with Pico feature 
obviously appeals to retro geeks like 
me who remember the 8-bit days 
with love and affection. I learnt 
coding and computing by 
experimentation. Retro computing 
on a modern device, like Pico, also 
shows how cutting-edge technology 
can trace a path back to earlier days 
and help us gain an understanding of 
computing development. Hl 


Lucy Hattersley 


Lucy is editor of The MagPi and is 
dancing like nobody is watching. 
Everybody is watching. 
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HiPi.io 


HIGHPI PRO 


»-—— The new case from the HiPi.io team ———————- 


e Rapid tool-free assembly and disassembly ® Secure microSD card cover 

e Large internal volume for HATs e VESA mount support 

e Compatible with Pi 2/3/4 e Molding-configurable output ports 
e Multiple lid options customizable for volume orders 

e Passive & Active Cooling options e Printed logo for your branding 


Available at these great Pi stores: 


Ly 4 ew ew ys 
$Æ PiShop.us d*pPiShop.ca {*fPiShop.mx ED2¿PiHut Pr$Hop.cH Welectron. 


Contact your favorite Pi store if it’s not listed here 
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PIKVM 


Manage your servers or 
workstations remotely 


A cost-effective solution for data-centers, 
IT departments or remote machines! 


PiKVM HAT 


for DIY and custom projects Pre-Assembled version 


e Real-time clock with rechargeable super capacitor @ OLED Display e Bootable virtual CD-ROM 
& flash drive e Serial console ® Open-source API € integration ® Open-source software 


Available at the main Raspberry Pi resellers 


ES prishop.cz Welectron. lektor os D 


Prfucr.cn piut RÉ Pishop.us Groce 
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LECTA 


Reseller suggestions and inquiries: 


wholesale@hipi.io 


